Get-FormatData
Obtiene los datos de formato en la sesión actual.
Sintaxis
Default (Es el valor predeterminado).
Get-FormatData
[[-TypeName] <String[]>]
[-PowerShellVersion <Version>]
[<CommonParameters>]
Description
El cmdlet Get-FormatData obtiene los datos de formato en la sesión actual.
Los datos de formato en la sesión incluyen datos de formato de los archivos de formato Format.ps1xml, como los del directorio $PSHOME, datos de formato para módulos que se importan en la sesión, y datos de formato para comandos que se importan en su 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 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: Obtener datos de formato 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
En este ejemplo se 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 para 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 cmdlets Get-FormatData, 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 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 Bits.format.ps1xml especificado.
El comando final muestra un extracto del contenido del archivo format.ps1xml.
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 un TypeName especificado de tipo y la versión de PowerShell.
Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion
TypeNames FormatViewDefinition
--------- --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}
Parámetros
-PowerShellVersion
Especifique la versión de PowerShell que este cmdlet obtiene 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 al realizar la comunicación remota con equipos que ejecutan versiones anteriores de PowerShell.
Propiedades del parámetro
| Tipo: | Version |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Mandatory: | 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 pueden canalizar objetos a este cmdlet.
