Compartilhar via


Get-FormatData

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

Sintaxe

Get-FormatData [[-TypeName] <string[]>] [<CommonParameters>]

Descrição

O cmdlet Get-FormatData obtém os dados de formatação na sessão atual.

Os dados de formatação na sessão incluem dados de arquivos de formatação Format.ps1xml (como os do diretório $pshome), dados de formatação para módulos que você importa na sessão, além de dados de formatação para comandos que você importa em sua sessão usando o cmdlet Import-PSSession.

Você pode usar este 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 arquivos de formatação no Windows PowerShell, consulte about_Format.ps1xml.

Parâmetros

-TypeName <string[]>

Obtém apenas os dados de formatação com os nomes de tipos especificados. Insira os nomes de tipos. Os caracteres curinga são permitidos.

Necessário?

false

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

true

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

Nenhum

Você não pode canalizar a entrada para este cmdlet.

Saídas

System.Management.Automation.ExtendedTypeDefinition

Exemplo 1

C:\PS>get-formatdata

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





Exemplo 2

C:\PS>get-formatdata -typename Microsoft.Wsman*

Descrição
-----------
Esse comando obtém os itens de dados de formatação cujos nomes começam com "Microsoft.Wsman".





Exemplo 3

C:\PS>$f = get-formatdata -typename helpinfoshort

C:\PS> $f 

TypeName        FormatViewDefinition
--------        --------------------
HelpInfoShort   {help , TableControl}

C:\PS> $f.FormatViewDefinition[0].control

Headers                                                                    Rows
-------                                                                    ----
{System.Management.Automation.TableControlColumnHeader, System.Manageme... {System.Management.Automation.TableControlRow}


C:\PS> $f.FormatViewDefinition[0].control.headers

Label         Alignment      Width
-----         ---------      -----
Name          Left           33
Category      Left           9
              Undefined      0

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





Exemplo 4

C:\PS>$a = get-formatdata

C:\PS> import-module bitstransfer
C:\PS> $b = get-formatdata
C:\PS> compare-object $a $b

InputObject                                                SideIndicator
-----------                                                -------------
Microsoft.BackgroundIntelligentTransfer.Management.BitsJob =>


C:\PS> get-formatdata *bits* | export-formatdata -filepath c:\test\bits.format.ps1xml

C:\PS> get-content c:\test\bits.format.ps1xml

<?xml version="1.0" encoding="utf-8"?><Configuration><ViewDefinitions>
<View><Name>Microsoft.BackgroundIntelligentTransfer.Management.BitsJob</Name>
...

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

Os primeiros quatro comandos usam os cmdlets Get-FormatData, Import-Module e Compare-Object para identificar o tipo de formato que o módulo BitsTransfer acrescenta à sessão.

O quinto comando usa o cmdlet Get-FormatData para obter o tipo de formato que o módulo BitsTransfer acrescenta. Ele usa um operador de pipeline (|) para enviar o objeto de tipo de formato ao cmdlet Export-FormatData que o converte de volta para XML e o salva no arquivo format.ps1xml especificado. 

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





Consulte também

Conceitos

Export-FormatData
Update-FormatData