Compartir a través de

Get-FormatData

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Obtiene los datos de formato en la sesión actual.

Sintaxis

Get-FormatData
   [[-TypeName] <String[]>]
   [-PowerShellVersion <Version>]
   [<CommonParameters>]

Description

El cmdlet Get-FormatData obtiene los datos de formato en la sesión actual.

Los datos de formato de la sesión incluyen datos de formato de Format.ps1xml archivos de formato, como los del directorio $PSHOME, los datos de formato de los módulos que importe en la sesión y los datos de formato de los comandos que importe en la sesión mediante el cmdlet Import-PSSession.

Puede usar este cmdlet para examinar los datos de formato. A continuación, puede usar el cmdlet Export-FormatData para serializar los objetos, convertirlos en XML y guardarlos en Format.ps1xml archivos.

Para obtener más información sobre el formato de archivos en PowerShell, consulte about_Format.ps1xml.

Ejemplos

Ejemplo 1: Obtener todos los datos de formato

En este ejemplo se obtienen todos los datos de formato de la sesión.

Get-FormatData

Ejemplo 2: Obtención del formato de datos por nombre de tipo

En este ejemplo se obtienen los elementos de datos de formato cuyos nombres comienzan por System.Management.Automation.Cmd.

Get-FormatData -TypeName 'System.Management.Automation.Cmd*'

Ejemplo 3: Examen de un objeto de datos de formato

En este ejemplo se muestra cómo obtener un objeto de datos de formato y examinar sus propiedades.

$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

Ejemplo 4: Obtener datos de formato y exportarlos

En este ejemplo se muestra cómo usar Get-FormatData y Export-FormatData para exportar los datos de formato agregados por un 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>
...

Los cuatro primeros comandos usan los cmdlets Get-FormatData, Import-Moduley Compare-Object para identificar el tipo de formato que agrega el módulo bitsTransfer de a la sesión.

El quinto comando usa el cmdlet Get-FormatData para obtener el tipo de formato que agrega el módulo bitsTransfer de. Usa un operador de canalización (|) para enviar el objeto de tipo de formato al cmdlet Export-FormatData, que lo convierte en XML y lo guarda en el archivo format.ps1xml especificado.

El comando final muestra un extracto del contenido del archivo format.ps1xml.

Ejemplo 5: Obtención de datos de formato en función de la versión especificada de PowerShell

En este ejemplo se muestra cómo usar Get-FormatData para obtener datos de formato para un TypeName especificado y la versión de 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 la versión de PowerShell que obtiene este cmdlet para los datos de formato. Escriba un número de dos dígitos separado por un punto.

Este parámetro se agregó en PowerShell 5.1 para mejorar la compatibilidad cuando los equipos que ejecutan versiones anteriores de PowerShell.

Tipo:Version
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TypeName

Especifica los nombres de tipo que obtiene este cmdlet para los datos de formato. Escriba los nombres de tipo. Se permiten caracteres comodín.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

ExtendedTypeDefinition