Get-FormatData

  • Referência
Módulo:
Microsoft.PowerShell.Utility

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

Syntax

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 a formatação de dados de ficheiros de formatação, como os do $PSHOME diretório, a formatação de dados para módulos que importa para a sessão e a formatação de Format.ps1xml dados para comandos que importa para a sua sessão com o Import-PSSession cmdlet .

Pode utilizar este cmdlet para examinar os dados de formatação. Em seguida, pode utilizar o Export-FormatData cmdlet para serializar os objetos, convertê-los em XML e guardá-los em Format.ps1xml ficheiros.

Para obter mais informações sobre a formatação de ficheiros no PowerShell, veja 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 por 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 as respetivas 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á-lo

Este exemplo mostra como utilizar Get-FormatData e Export-FormatData exportar os dados de formatação que sã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 primeiros quatro comandos utilizam os Get-FormatDatacmdlets , Import-Modulee Compare-Object para identificar o tipo de formato que o módulo BitsTransfer adiciona à sessão.

O quinto comando utiliza o Get-FormatData cmdlet para obter o tipo de formato que o módulo BitsTransfer adiciona. Utiliza um operador de pipeline (|) para enviar o objeto de tipo de formato para o Export-FormatData cmdlet, que o converte novamente em XML e o guarda no ficheiro especificado format.ps1xml .

O comando final mostra um excerto do conteúdo do format.ps1xml ficheiro.

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

Este exemplo mostra como utilizar Get-FormatData para obter dados de formato para uma versão especificada do TypeName e do 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. Introduza um número de dois dígitos separado por um ponto final.

Este parâmetro foi adicionado ao PowerShell 5.1 para melhorar a compatibilidade ao comunicar computadores com versões mais antigas do PowerShell.

Type:Version
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TypeName

Especifica os nomes de tipo que este cmdlet obtém para os dados de formatação. Introduza os nomes dos tipos. São permitidos carateres universais.

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

Entradas

None

Não pode encaminhar objetos para este cmdlet.

Saídas

ExtendedTypeDefinition