Get-FormatData
Obtém os dados de formatação na sessão atual.
Sintaxe
Default (Padrão)
Get-FormatData
[[-TypeName] <String[]>]
[-PowerShellVersion <Version>]
[<CommonParameters>]
Description
O cmdlet Get-FormatData obtém os dados de formatação na sessão atual.
Os dados de formatação na sessão incluem a formatação de dados de arquivos de formatação Format.ps1xml, como os do diretório $PSHOME, a formatação de dados para módulos importados para a sessão e a formatação de dados para os comandos importados para a sessão usando o cmdlet Import-PSSession.
Você pode usar esse cmdlet para examinar os dados de formatação. Em seguida, você pode usar o cmdlet Export-FormatData para serializar os objetos, convertê-los em XML e salvá-los em arquivos Format.ps1xml.
Para obter mais informações sobre como formatar arquivos no PowerShell, consulte about_Format.ps1xml.
Exemplos
Exemplo 1: Obter todos os dados de formatação
Este exemplo obtém todos os dados de formatação na sessão.
Get-FormatData
Exemplo 2: Obter dados de formatação por nome de tipo
Este exemplo obtém os itens de dados de formatação cujos nomes começam com System.Management.Automation.Cmd.
Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
Exemplo 3: examinar um objeto de dados de formatação
Este exemplo mostra como obter um objeto de dados de formatação e examinar suas propriedades.
$F = Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
$F
TypeName FormatViewDefinition
-------- --------------------
HelpInfoShort {help , TableControl}
$F.FormatViewDefinition[0].Control
Headers : {System.Management.Automation.TableControlColumnHeader,
System.Management.Automation.TableControlColumnHeader,
System.Management.Automation.TableControlColumnHeader,
System.Management.Automation.TableControlColumnHeader}
Rows : {System.Management.Automation.TableControlRow}
AutoSize : False
HideTableHeaders : False
GroupBy :
OutOfBand : False
$F.FormatViewDefinition[0].Control.Headers
Label Alignment Width
----- --------- -----
CommandType Undefined 15
Name Undefined 50
Version Undefined 10
Source Undefined 0
Exemplo 4: Obter dados de formatação e exportá-los
Este exemplo mostra como usar Get-FormatData e Export-FormatData para exportar os dados de formatação adicionados por um módulo.
$A = Get-FormatData
Import-Module BitsTransfer
$B = Get-FormatData
Compare-Object $A $B
InputObject SideIndicator
----------- -------------
Microsoft.BackgroundIntelligentTransfer.Management.BitsJob =>
Get-FormatData *bits* | Export-FormatData -FilePath C:\test\Bits.format.ps1xml
Get-Content C:\test\Bits.format.ps1xml
<?xml version="1.0" encoding="utf-8"?><Configuration><ViewDefinitions>
<View><Name>Microsoft.BackgroundIntelligentTransfer.Management.BitsJob</Name>
...
Os quatro primeiros comandos usam os cmdlets Get-FormatData, Import-Modulee Compare-Object para identificar o tipo de formato que o módulo BitsTransfer adiciona à sessão.
O quinto comando usa o cmdlet Get-FormatData para obter o tipo de formato que o módulo BitsTransfer adiciona. Ele usa um operador de pipeline (|) para enviar o objeto de tipo de formato para o cmdlet Export-FormatData, que o converte de volta em XML e o salva no arquivo de Bits.format.ps1xml especificado.
O comando final mostra um trecho do conteúdo do arquivo format.ps1xml.
Exemplo 5: Obter dados de formatação com base na versão especificada do PowerShell
Este exemplo mostra como usar Get-FormatData para obter dados de formato para um TypeName especificado e uma versão do PowerShell.
Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion
TypeNames FormatViewDefinition
--------- --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}
Parâmetros
-PowerShellVersion
Especifique a versão do PowerShell que este cmdlet obtém para os dados de formatação. Insira um número de dois dígitos separado por um período.
Esse parâmetro foi adicionado no PowerShell 5.1 para melhorar a compatibilidade durante a comunicação remota para computadores que executam versões mais antigas do PowerShell.
Propriedades do parâmetro
| Tipo: | Version |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TypeName
Especifica os nomes de tipo que esse cmdlet obtém para os dados de formatação. Insira os nomes de tipo. Caracteres curinga são permitidos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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
None
Não é possível transferir objetos para esse cmdlet.
