Export-FormatData
Salva dados de formatação da sessão atual em um arquivo de formatação.
Sintaxe
ByPath (Predefinição)
Export-FormatData
-InputObject <ExtendedTypeDefinition[]>
-Path <String>
[-Force]
[-NoClobber]
[-IncludeScriptBlock]
[<CommonParameters>]
ByLiteralPath
Export-FormatData
-InputObject <ExtendedTypeDefinition[]>
-LiteralPath <String>
[-Force]
[-NoClobber]
[-IncludeScriptBlock]
[<CommonParameters>]
Description
O cmdlet Export-FormatData cria arquivos de formatação do PowerShell (format.ps1xml) a partir dos objetos de formatação na sessão atual. Ele recolhe os objetos ExtendedTypeDefinition que Get-FormatData retorna e os salva em um ficheiro em formato XML.
O PowerShell usa os dados em arquivos de formatação (format.ps1xml) para gerar a exibição padrão de objetos do Microsoft .NET Framework na sessão. Você pode exibir e editar os arquivos de formatação e usar o cmdlet Update-FormatData para adicionar os dados de formatação a uma sessão.
Para obter mais informações sobre como formatar arquivos no PowerShell, consulte about_Format.ps1xml.
Exemplos
Exemplo 1: Exportar dados de formato de sessão
Get-FormatData -TypeName "*" |
Export-FormatData -Path "AllFormat.ps1xml" -IncludeScriptBlock
Este comando exporta todos os dados de formato na sessão para o arquivo AllFormat.ps1xml.
O comando usa o cmdlet Get-FormatData para obter os dados de formato na sessão. Um valor de
O comando usa um operador de pipeline (|) para enviar os dados de formato do comando Get-FormatData para o cmdlet Export-FormatData, que exporta os dados de formato para o arquivo AllFormat.ps1xml.
O comando Export-FormatData usa o parâmetro IncludeScriptBlock para incluir blocos de script nos dados de formato no arquivo.
Exemplo 2: Exportar dados de formato para um tipo
$F = Get-FormatData -TypeName "HelpInfoShort"
Export-FormatData -InputObject $F -Path "C:\test\Help.format.ps1xml" -IncludeScriptBlock
Esses comandos exportam os dados de formato para o tipo de HelpInfoShort para o arquivo Help.format.ps1xml.
O primeiro comando usa o cmdlet
O segundo comando usa o parâmetro InputObject do cmdlet Export-FormatData para inserir os dados de formato salvos na variável $F. Ele também usa o parâmetro IncludeScriptBlock para incluir blocos de script na saída.
Exemplo 3: Exportar dados de formato sem um bloco de script
Get-FormatData -TypeName "System.Diagnostics.Process" |
Export-FormatData -Path Process.format.ps1xml
Update-FormatData -PrependPath ".\Process.format.ps1xml"
Get-Process p*
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
323 5600 powershell
336 3900 powershell_ise
138 4076 PresentationFontCache
Este exemplo mostra o efeito de omitir o parâmetro IncludeScriptBlock de um comando Export-FormatData.
O primeiro comando usa o cmdlet |) para enviar os dados de formatação para o cmdlet Export-FormatData, que os exporta para o arquivo Process.format.ps1xml no diretório atual.
Nesse caso, o comando
O segundo comando usa o cmdlet Update-FormatData para adicionar o arquivo Process.format.ps1xml à sessão atual. O comando usa o parâmetro PrependPath para garantir que os dados de formatação para objetos de processo no arquivo Process.format.ps1xml sejam encontrados antes dos dados de formatação padrão para objetos de processo.
O terceiro comando mostra os efeitos dessa mudança. O comando usa o cmdlet Get-Process para obter processos com nomes que começam com P. A saída mostra que os valores de propriedade que são calculados usando blocos de script estão faltando na exibição.
Parâmetros
-Force
Força o comando a ser executado sem pedir a confirmação do usuário.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-IncludeScriptBlock
Indica se os blocos de script no formato de dados são exportados.
Como os blocos de script contêm código e podem ser usados maliciosamente, eles não são exportados por padrão.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InputObject
Especifica o formato de objetos de dados a serem exportados. Insira uma variável que contenha os objetos ou um comando que obtenha os objetos, como um comando Get-FormatData. Você também pode canalizar os objetos de Get-FormatData para Export-FormatData.
Propriedades dos parâmetros
| Tipo: | |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-LiteralPath
Especifica um local para o arquivo de saída. Ao contrário do parâmetro Path, o valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como carta curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell para não interpretar quaisquer caracteres como sequências de escape.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | PSPath, LP |
Conjuntos de parâmetros
ByLiteralPath
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-NoClobber
Indica que o cmdlet não substitui arquivos existentes. Por padrão, Export-FormatData substitui arquivos sem aviso, a menos que o arquivo tenha o atributo somente leitura.
Para direcionar Export-FormatData para sobrescrever arquivos de apenas leitura, use o parâmetro Force.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | NoOverwrite |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Path
Especifica um local para o arquivo de saída. Insira um caminho (opcional) e um nome de arquivo com uma extensão de nome de arquivo format.ps1xml. Se você omitir o caminho, Export-FormatData criará o arquivo no diretório atual.
Se você usar uma extensão de nome de arquivo diferente de .ps1xml, o cmdlet Update-FormatData não reconhecerá o arquivo.
Se você especificar um arquivo existente, Export-FormatData substituirá o arquivo sem aviso, a menos que o arquivo tenha o atributo somente leitura. Para substituir um arquivo somente leitura, use o parâmetro Force. Para evitar que os arquivos sejam substituídos, use o parâmetro NoClobber.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | FilePath |
Conjuntos de parâmetros
ByPath
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
ExtendedTypeDefinition
Você pode passar objetos ExtendedTypeDefinition de Get-FormatData para este cmdlet.
Saídas
None
Este cmdlet não retorna nenhuma saída. Ele gera um arquivo e o salva no caminho especificado.
Notas
- Para usar qualquer arquivo de formatação, incluindo um arquivo de formatação exportado, a política de execução da sessão deve permitir a execução de scripts e arquivos de configuração. Para obter mais informações, consulte about_Execution_Policies.
