Get-FormatData
Obtém os dados de formatação na sessão atual.
Sintaxe
Default (Predefinição)
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 dos ficheiros de formatação Format.ps1xml, como os que estão no diretório $PSHOME, dados de formatação para módulos que se importa para a sessão e dados de formatação para comandos que se importa para a 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 Bits.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 se comunicar com computadores que executam versões mais antigas do PowerShell.
Propriedades dos parâmetros
| Tipo: | Version |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
None
Não é possível canalizar objetos para este cmdlet.
