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 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 formatação de Format.ps1xml arquivos de formatação, como aqueles no diretório $PSHOME, dados de 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 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

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 para 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 cmdlets Get-FormatData, Import-Modulee 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 de format.ps1xml especificado.

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

Exemplo 5: Obter dados de formatação com base na versão especificada do PowerShell

Este exemplo mostra como usar o Get-FormatData para obter dados de formato para uma versão especificada 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