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.