Compartilhar via

Get-FormatData

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Obtém os dados de formatação na sessão atual.

Sintaxe

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 dados de formatação de arquivos de formatação, como aqueles $PSHOME no diretório, dados de formatação para módulos importados para a sessão e formatação de dados para comandos importados Format.ps1xml para a 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

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 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 primeiros quatro 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 Export-FormatData cmdlet, que o 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 de TypeName e PowerShell.

Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion

TypeNames                               FormatViewDefinition
---------                               --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}

Importante

Para garantir que as informações completas de formatação de tipo sejam retornadas, você sempre deve incluir o parâmetro PowerShellVersion com a versão apropriada. Se o parâmetro e o valor forem omitidos, talvez você não obtenha todas as informações de tipo corretas.

Parâmetros

-PowerShellVersion

Especifique a versão do PowerShell que esse cmdlet obtém para os dados de formatação. Digite um número de dois dígitos separados por um ponto.

Esse parâmetro foi adicionado no PowerShell 5.1 para melhorar a compatibilidade ao conectar computadores que executam versões mais antigas do PowerShell.

Tipo:Version
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

Entradas

None

Você não pode canalizar objetos para esse cmdlet.

Saídas

ExtendedTypeDefinition