Compartir a través de

Get-FormatData

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

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

Sintaxis

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

Description

El Get-FormatData cmdlet 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 $PSHOME directorio, los datos de formato de los módulos que se importan en la sesión y los datos de formato de los comandos que se importan en la sesión mediante el Import-PSSession cmdlet .

Este cmdlet se puede usar para examinar los datos de formato. A continuación, puede usar el Export-FormatData cmdlet 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

Este ejemplo 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 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 Get-FormatDatacmdlets , Import-Moduley Compare-Object para identificar el tipo de formato que el módulo BitsTransfer agrega a la sesión.

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

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

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 una versión de TypeName y PowerShell especificadas.

Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion

TypeNames                               FormatViewDefinition
---------                               --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}

Importante

Para asegurarse de que se devuelve la información de formato de tipo completa, siempre debe incluir el parámetro PowerShellVersion con la versión adecuada. Si se omite el parámetro y el valor, es posible que no obtenga toda la información de tipo correcta.

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 tipos. Se permiten los 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