Compartir a través de

Get-FormatData

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

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

Syntax

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

Description

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

Los datos de formato de la sesión incluyen datos de formato de archivos de formato Format.ps1xml, 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.

Este cmdlet se puede usar 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 archivos Format.ps1xml.

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

Este comando obtiene todos los datos de formato en la sesión.

Get-FormatData

Ejemplo 2: Obtener datos de formato por nombre de tipo

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

Este comando obtiene los elementos de datos de formato cuyos nombres comienzan por System.Management.Automation.Cmd*.

Ejemplo 3: Examen de un objeto de datos de formato

$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
-----         ---------      -----
Name          Left           33
Category      Left           9
Undefined      0

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

Ejemplo 4: Obtener datos de formato y exportarlos

$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>
...

En este ejemplo se muestra cómo usar Get-FormatData y Export-FormatData para exportar los datos de formato agregados por un módulo.

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

El quinto comando usa el cmdlet Get-FormatData 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 cmdlet Export-FormatData, que lo convierte de nuevo en XML y lo guarda en el archivo Format.ps1xml especificado.

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

Parámetros

-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.

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

Entradas

None

No se puede canalizar la entrada a este cmdlet.

Salidas

ExtendedTypeDefinition