Partilhar 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 Format.ps1xml formatação para módulos que você importa para a sessão e dados de formatação para comandos que você importa para sua sessão usando o Import-PSSession cmdlet.

Você pode usar esse 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 quatro primeiros comandos usam os Get-FormatDatacmdlets , Import-Modulee para Compare-Object 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}

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 separados por um ponto.

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

Tipo:Version
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TypeName

Especifica os nomes de tipo que esse cmdlet obtém para os dados de formatação. Insira os nomes dos tipos. Curingas são permitidos.

Tipo:String[]
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

Entradas

None

Não é possível canalizar objetos para este cmdlet.

Saídas

ExtendedTypeDefinition