Get-FormatData
Obtiene los datos de formato en la sesión actual.
Sintaxis
Default (valor predeterminado)
Get-FormatData
[[-TypeName] <String[]>]
[<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 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.
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 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 de 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
En este ejemplo se 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 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.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
None
No se puede canalizar la entrada a este cmdlet.