Out-File (Português)

posted in: Articles | 0
Module: Microsoft.PowerShell.O utilitário

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-Contentobté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-Locationutiliza o parâmetro Path para definir a localização actual para o registradorAlias:. OGet-Location cmdlet mostra o caminho completo paraAlias:.,Get-ChildItemenvia 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

adiciona o resultado ao fim de um ficheiro existente.,

Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm

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
-Encoding

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
-FilePath

Specifies the path to the output file.,

Type: String
Aliases: Path
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force

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
-InputObject

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
-LiteralPath

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

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
-NoNewline

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
-WhatIf

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
-Width

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-Filecmdlet.,

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

O seu endereço de email não será publicado. Campos obrigatórios marcados com *