Get-FormatData
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-FormatData
cmdlets , Import-Module
e 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
Ligações Relacionadas
Comentários
Submeter e ver comentários