Get-FormatData
Obtém os dados de formatação na sessão atual.
Syntax
Get-FormatData
[[-TypeName] <String[]>]
[-PowerShellVersion <Version>]
[<CommonParameters>] Description
O Get-FormatData cmdlet 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 Format.ps1xml formatação, como aqueles no $PSHOME diretório, formatação de dados para módulos importados para a sessão e formatação de dados para comandos importados para sua sessão usando o Import-PSSession cmdlet .
Você pode usar este cmdlet para examinar os dados de formatação. Em seguida, você pode usar o Export-FormatData cmdlet para serializar os objetos, convertê-los em XML e salvá-los em Format.ps1xml arquivos.
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 -PowerShellVersion 5.1Importante
Para garantir que as informações completas de formatação de tipo sejam retornadas, você sempre deve incluir o parâmetro PowerShellVersion com o valor 5.1 ao usar uma invocação local de Get-FormatData. Se o parâmetro e o valor forem omitidos, talvez você não obtenha todas as informações de tipo corretas.
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*' -PowerShellVersion 5.1Exemplo 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*' -PowerShellVersion 5.1
$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 0Exemplo 4: Obter dados de formatação e exportá-los
Este exemplo mostra como usar Get-FormatData e Export-FormatData exportar os dados de formatação adicionados por um módulo.
$A = Get-FormatData -PowerShellVersion 5.1
Import-Module bitstransfer
$B = Get-FormatData -PowerShellVersion 5.1
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 Get-FormatDatacmdlets , Import-Modulee Compare-Object para identificar o tipo de formato que o módulo BitsTransfer adiciona à sessão.
O quinto comando usa o Get-FormatData cmdlet 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 , que o Export-FormatData converte de volta em XML e o salva no arquivo especificado format.ps1xml .
O comando final mostra um trecho do conteúdo do format.ps1xml arquivo.
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 uma versão especificada do TypeName e 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 ponto.
Esse parâmetro foi adicionado no PowerShell 5.1 para melhorar a compatibilidade ao realizar a comunicação remota de computadores que executam versões mais antigas do PowerShell.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
Entradas
None
Não é possível redirecionar a entrada para este cmdlet.