envia o resultado para um ficheiro.
Sintaxe
Descrição
Out-File
cmdlet envia a saída para um arquivo. Ele implicitamente usa o sistema de formatação PowerShell para o arquivo. O arquivo recebe a mesma representação de exibição que o terminal. Isto significa que a saída pode não ser ideal para processamento programático, a menos que todos os objetos de entrada sejam strings.,Quando precisar de especificar parâmetros para a saída, use Out-File
em vez do redirectionoperador (>
). Para mais informações sobre redirecionamento, consulte about_Redirection.
exemplos
exemplo 1: Enviar a saída e criar um ficheiro
este exemplo mostra como enviar uma lista dos processos do computador local para um ficheiro. Se o ficheiro não existir, Out-File
cria o ficheiro na localização indicada.
TheGet-Process
cmdlet gets the list of processes running on the local computer., Os Processobjets são enviados para o gasoduto Out-File
cmdlet. Out-File
usa o FilePathparameter e cria um arquivo no diretório atual chamado Process.txt. O comando Get-Content
obtém o conteúdo do arquivo e o exibe na consola PowerShell.
Exemplo 2: evitar que um ficheiro existente seja substituído por outro
este exemplo impede que um ficheiro existente seja substituído. Por padrão, Out-File
overwritesexisting files.,
TheGet-Process
cmdlet gets the list of processes running on the local computer. Os Processobjets são enviados para o gasoduto Out-File
cmdlet. Out-File
usa o FilePathparameter e tenta escrever para um arquivo no diretório atual chamado Process.txt. O parâmetro TheNoClobber impede que o arquivo seja substituído e exibe uma mensagem que o arquivo já existe.
exemplo 3: Enviar o resultado para um ficheiro no formato ASCII
este exemplo mostra como codificar o resultado com um tipo de codificação específico.,
$Procs = Get-ProcessOut-File -FilePath .\Process.txt -InputObject $Procs -Encoding ASCII -Width 50
The Get-Process
cmdlet gets the list of processes running on the local computer. Os Processobjets são armazenados na variável, $Procs
. Out-File
usa o parâmetro FilePath e o arquivo createsa no diretório atual chamado processo.txt. O parâmetro InputObject passa os objetos do processo em $Procs
para o processo de arquivo.txt. O parâmetro de codificação converte a saída para o formato ASCII. O parâmetro largura limita cada linha do arquivo a 50 caracteres de dados sosome pode ser truncado.,
exemplo 4: Use um provedor e envie a saída para um arquivo
este exemplo mostra como usar o Out-File
cmdlet quando você não está em um sistema de arquivos providerdrive. Use oGet-PSProvider
cmdlet para ver os fornecedores no seu computador local. Para mais informações, consulte os fornecedores.
o comando Set-Location
utiliza o parâmetro Path para definir a localização actual para o registradorAlias:
. OGet-Location
cmdlet mostra o caminho completo paraAlias:
.,Get-ChildItem
envia objetos para o gasodutoOut-File
cmdlet. Out-File
C:\TestDir\AliasNames.txt. OGet-Content
cmdlet usa o parâmetro Path e exibe o conteúdo do ficheiro na consola PowerShell.
parâmetros
adiciona o resultado ao fim de um ficheiro existente.,
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Prompts you for confirmation before running the cmdlet.,
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies the type of encoding for the target file. The default value is utf8NoBOM
.,
os valores aceitáveis para este parâmetro são os seguintes:
-
ascii
: utiliza a codificação para o conjunto de caracteres ASCII (7 bits). -
bigendianunicode
: codes in UTF-16 format using the big-endian byte order. -
bigendianutf32
: codifica no formato UTF-32 usando a ordem de bytes big-endian. -
oem
: usa a codificação padrão para MS-DOS e programas de consola. -
unicode
: codes in UTF-16 format using the little-endian byte order., -
utf7
: codifica no formato UTF-7. -
utf8
: codifica no formato UTF-8. -
utf8BOM
: Codifica no formato UTF-8 com Marca de Ordem de Byte (BOM) -
utf8NoBOM
: Codifica no formato UTF-8 sem Marca de Ordem de Byte (BOM) -
utf32
: Codifica em UTF-32 formato.
começando com PowerShell 6.,2, The Encoding parameter also allows numeric IDs of registered codepages (like -Encoding 1251
) or string names of registered code pages (like-Encoding "windows-1251"
). Para mais informações, consulte a documentação. net forEncoding.codigo.
Nota
UTF-7 * já não é recomendada a sua utilização. Em PowerShell 7.1, um aviso é escrito se você especificar utf7
para o parâmetro de codificação.,
Type: | Encoding |
Accepted values: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
Position: | 1 |
Default value: | UTF8NoBOM |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies the path to the output file.,
Type: | String |
Aliases: | Path |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Overrides the read-only attribute and overwrites an existing read-only file. The Force parameterdoes not override security restrictions.,
Tipo: | SwitchParameter |
Cargo: | Nome |
valor Padrão: | None |
Aceita a entrada de pipeline: | False |
Aceita caracteres curinga: | False |
Especifica os objetos a serem gravados para o arquivo. Indique uma variável que contenha os objectos ou o comando typea ou a expressão que obtém os objectos.,
Tipo: | PSObject |
Cargo: | Nome |
valor Padrão: | None |
Aceita a entrada de pipeline: | True |
Aceita caracteres curinga: | False |
Especifica o caminho para o arquivo de saída. O parâmetro LiteralPath é usado exatamente como é digitado.Os caracteres especiais não são aceites. Se o caminho incluir caracteres de escape, enclausurá-lo em marcas únicas., Aspas simples dizem a PowerShell para não interpretar quaisquer caracteres como escapesequências. Para mais informações, consulte as regras do sítio.,
Type: | String |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
NoClobber prevents an existing file from being overwritten and displays a message that the filealready exists., Por omissão, se um ficheiro existir na localização indicada, Out-File
substitui o aviso de saída do ficheiro.,
Tipo: | SwitchParameter |
Aliases: | NoOverwrite |
Cargo: | Nome |
valor Padrão: | None |
Aceita a entrada de pipeline: | False |
Aceita caracteres curinga: | False |
Especifica que o conteúdo escrito para o arquivo não termina com um caractere de nova linha. The stringrepresentations of the input objects are concatened to form the output., Não são assinalados espaços ou linhas novas entre as cadeias de saída. Não é adicionada nenhuma nova linha após o último texto de saída.
Tipo: | SwitchParameter |
Cargo: | Nome |
valor Padrão: | None |
Aceita a entrada de pipeline: | False |
Aceita caracteres curinga: | False |
Mostra o que aconteceria se o cmdlet é executado. O cmdlet não é executado.,
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies the number of characters in each line of output. Any additional characters are truncated,not wrapped., Se este parâmetro não for utilizado, a largura é determinada pelas características do poste. O padrão para a consola PowerShell é de 80 caracteres.
Tipo: | Int32 |
Cargo: | Nome |
valor Padrão: | None |
Aceita a entrada de pipeline: | False |
Aceita caracteres curinga: | False |
Entradas
PSObject
Você pode enviar qualquer objeto Out-File
.,
Saídas
Nenhum
Out-File
não gera nenhuma saída.
Notas
Entrada de objetos são automaticamente formatados como seriam no terminal, mas você pode usar umFormat-*
cmdlet para controlar explicitamente a formatação de saída para o arquivo. Por exemplo,Get-Date | Format-List | Out-File out.txt
para enviar um comando PowerShell para oOut-File
cmdlet, use o pipeline. Alternativamente, você pode armazenar dados em uma variável e usar o parâmetro InputObject para passar dados para o Out-File
cmdlet.,
Out-File
guarda dados para um ficheiro, mas não produz quaisquer objectos de saída para o gasoduto.
- about_Providers
- about_Quoting_Rules
- Fora do Padrão
- Out-Host
- Fora-Null
- Fora de Seqüência de caracteres
- Tee-Objeto
Deixe uma resposta