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