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

Sintaxis

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

Descripción

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

Los datos de formato de la sesión incluyen los datos de formato de los archivos de formato Format.ps1xml (por ejemplo, los ubicados en el directorio $pshome), 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 cmdlet Import-PSSession.

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

Para obtener más información sobre los archivos de formato de Windows PowerShell, vea about_Format.ps1xml.

Parámetros

-TypeName <string[]>

Obtiene solo los datos de formato con los nombres de tipo especificados. Escriba los nombres de los tipos. Se permite el uso de caracteres comodín.

¿Requerido?

false

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

true

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

Ninguno

No se pueden canalizar entradas a este cmdlet.

Salidas

System.Management.Automation.ExtendedTypeDefinition

Ejemplo 1

C:\PS>get-formatdata

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






Ejemplo 2

C:\PS>get-formatdata -typename Microsoft.Wsman*

Descripción
-----------
Este comando obtiene los elementos de los datos de formato cuyo nombre comienza con "Microsoft.Wsman".






Ejemplo 3

C:\PS>$f = get-formatdata -typename helpinfoshort

C:\PS> $f 

TypeName        FormatViewDefinition
--------        --------------------
HelpInfoShort   {help , TableControl}

C:\PS> $f.FormatViewDefinition[0].control

Headers                                                                    Rows
-------                                                                    ----
{System.Management.Automation.TableControlColumnHeader, System.Manageme... {System.Management.Automation.TableControlRow}


C:\PS> $f.FormatViewDefinition[0].control.headers

Label         Alignment      Width
-----         ---------      -----
Name          Left           33
Category      Left           9
              Undefined      0

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






Ejemplo 4

C:\PS>$a = get-formatdata

C:\PS> import-module bitstransfer
C:\PS> $b = get-formatdata
C:\PS> compare-object $a $b

InputObject                                                SideIndicator
-----------                                                -------------
Microsoft.BackgroundIntelligentTransfer.Management.BitsJob =>


C:\PS> get-formatdata *bits* | export-formatdata -filepath c:\test\bits.format.ps1xml

C:\PS> get-content c:\test\bits.format.ps1xml

<?xml version="1.0" encoding="utf-8"?><Configuration><ViewDefinitions>
<View><Name>Microsoft.BackgroundIntelligentTransfer.Management.BitsJob</Name>
...

Descripción
-----------
En este ejemplo, se muestra cómo utilizar 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 utiliza el cmdlet Get-FormatData para obtener el tipo de formato que el módulo BitsTransfer agrega. Utiliza 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 último comando muestra un extracto del archivo format.ps1xml.






Vea también




Tabla de contenido