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[]>]
   [<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

Esse comando obtém todos os dados de formatação na sessão.

Get-FormatData

Exemplo 2: Obter dados de formatação por nome de tipo

Get-FormatData -TypeName 'System.Management.Automation.Cmd*'

Esse comando obtém os itens de dados de formatação cujos nomes começam com System.Management.Automation.Cmd*.

Exemplo 3: examinar um objeto de dados de formatação

$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
-----         ---------      -----
Name          Left           33
Category      Left           9
Undefined      0

Este exemplo mostra como obter um objeto de dados de formatação e examinar suas propriedades.

Exemplo 4: Obter dados de formatação e exportá-los

$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>
...

Este exemplo mostra como usar Get-FormatData e Export-FormatData para exportar os dados de formatação adicionados por um módulo.

Os quatro primeiros comandos usam os cmdlets Get-FormatData, Import-Module e 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 format.ps1xml especificado.

O comando final mostra um trecho do conteúdo do arquivo format.ps1xml.

Parâmetros

-TypeName

Especifica os nomes de tipo que esse cmdlet obtém para os dados de formatação. Insira os nomes de tipo. Curingas 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

Não é possível redirecionar a entrada para este cmdlet.

Saídas

ExtendedTypeDefinition