Compartir a través de

Update-TypeData

Módulo:
Microsoft.PowerShell.Utility Module

Actualiza los datos de tipo extendido en la sesión.

Sintaxis

FileSet (Es el valor predeterminado). 

Update-TypeData
    [[-AppendPath] <String[]>]
    [-PrependPath <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DynamicTypeSet 

Update-TypeData
    -TypeName <String>
    [-MemberType <PSMemberTypes>]
    [-MemberName <String>]
    [-Value <Object>]
    [-SecondValue <Object>]
    [-TypeConverter <Type>]
    [-TypeAdapter <Type>]
    [-SerializationMethod <String>]
    [-TargetTypeForDeserialization <Type>]
    [-SerializationDepth <Int32>]
    [-DefaultDisplayProperty <String>]
    [-InheritPropertySerializationSet <Nullable`1>]
    [-StringSerializationSource <String>]
    [-DefaultDisplayPropertySet <String[]>]
    [-DefaultKeyPropertySet <String[]>]
    [-PropertySerializationSet <String[]>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

TypeDataSet 

Update-TypeData
    [-TypeData] <TypeData[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Update-TypeData actualiza los datos de tipo extendido en la sesión mediante la recarga de los archivos Types.ps1xml en memoria y la adición de nuevos datos de tipo extendido.

De forma predeterminada, PowerShell carga los datos de tipo extendido según sea necesario. Sin parámetros, Update-TypeData vuelve a cargar todos los archivos de Types.ps1xml que ha cargado en la sesión, incluidos los archivos de tipo que haya agregado. Puede usar los parámetros de Update-TypeData para agregar nuevos archivos de tipo y agregar y reemplazar datos de tipo extendido.

El cmdlet Update-TypeData se puede usar para cargar previamente todos los datos de tipo. Esta característica es especialmente útil cuando está desarrollando tipos y desea cargar esos nuevos tipos con fines de prueba.

A partir de Windows PowerShell 3.0, puede usar Update-TypeData para agregar y reemplazar datos de tipo extendido en la sesión sin usar un archivo Types.ps1xml. Los datos de tipo que se agregan dinámicamente, es decir, sin un archivo, solo se agregan a la sesión actual. Para agregar los datos de tipo a todas las sesiones, agregue un comando Update-TypeData al perfil de PowerShell. Para obtener más información, vea about_Profiles.

Además, a partir de Windows PowerShell 3.0, puede usar el cmdlet Get-TypeData para obtener los tipos extendidos en la sesión actual y el cmdlet Remove-TypeData para eliminar tipos extendidos de la sesión actual.

Las excepciones que se producen en las propiedades o al agregar propiedades a un comando Update-TypeData no notifican errores. Esto es para suprimir las excepciones que se producirían en muchos tipos comunes durante los procesos de formato y salida de datos. Si va a obtener las propiedades de .NET, puede evitar la supresión de las excepciones utilizando la sintaxis de método en su lugar, como se muestra en el ejemplo siguiente:

"hello".get_Length()

Tenga en cuenta que la sintaxis del método solo se puede usar con propiedades de .NET. Las propiedades que se agregan mediante la ejecución del cmdlet Update-TypeData no pueden usar la sintaxis del método.

Para obtener más información sobre los archivos de Types.ps1xml en PowerShell, consulte about_Types.ps1xml.

Ejemplos

Ejemplo 1: Actualización de tipos extendidos

Update-TypeData

Este comando actualiza la configuración de tipo extendido de los archivos de Types.ps1xml que ya se han usado en la sesión.

Ejemplo 2: Actualizar tipos varias veces

En este ejemplo se muestra cómo actualizar los tipos de un archivo de tipo varias veces en la misma sesión.

El primer comando actualiza la configuración de tipo extendido de los archivos Types.ps1xml, procesando primero los archivos TypesA.types.ps1xml y TypesB.types.ps1xml.

El segundo comando muestra cómo actualizar el TypesA.types.ps1xml de nuevo, como puede hacer si agregó o cambió un tipo en el archivo. Puede repetir el comando anterior para el archivo TypesA.types.ps1xml o ejecutar un comando Update-TypeData sin parámetros, ya que TypesA.types.ps1xml ya está en la lista de archivos de tipo para la sesión actual.

Update-TypeData -PrependPath TypesA.types.ps1xml, TypesB.types.ps1xml
Update-TypeData -PrependPath TypesA.types.ps1xml

Ejemplo 3: Adición de una propiedad de script a objetos DateTime

En este ejemplo se usa Update-TypeData para agregar la propiedad de script QuarterSystem.DateTime objetos de la sesión actual, como los devueltos por el cmdlet Get-Date.

$typeDataParams = @{
    TypeName   = 'System.DateTime'
    MemberType = 'ScriptProperty'
    MemberName = 'Quarter'
    Value      = {
        switch ($this.Month) {
            { $_ -in @(1, 2, 3) } { return 'Q1' }
            { $_ -in @(4, 5, 6) } { return 'Q2' }
            { $_ -in @(7, 8, 9) } { return 'Q3' }
            default               { return 'Q4' }
        }
    }
}
Update-TypeData @typeDataParams

(Get-Date).Quarter

Q1

El comando Update-TypeData usa el parámetro TypeName para especificar tipo System.DateTime, el parámetro MemberName para especificar un nombre para la nueva propiedad, la propiedad MemberType para especificar el tipo ScriptProperty y el parámetro Value para especificar el script que determina el trimestre anual.

El valor de la propiedad Value es un script que calcula el trimestre anual actual. El bloque de script usa el $this variable automática para representar la instancia actual del objeto y el operador In para determinar si el valor del mes aparece en cada matriz de enteros. Para obtener más información sobre el operador -in, consulte about_Comparison_Operators.

El segundo comando obtiene la nueva propiedad Quarter de la fecha actual.

Ejemplo 4: Actualización de un tipo que se muestra en listas de forma predeterminada

En este ejemplo se muestra cómo establecer las propiedades de un tipo que se muestra en listas de forma predeterminada, es decir, cuando no se especifica ninguna propiedad. Dado que los datos de tipo no se especifican en un archivo Types.ps1xml, solo es efectivo en la sesión actual.

Get-Date | Format-List

Update-TypeData -TypeName "System.DateTime" -DefaultDisplayPropertySet @(
    'DateTime'
    'DayOfYear'
    'Quarter'
)

Get-Date | Format-List

DisplayHint : DateTime
Date        : 8/7/2024 12:00:00 AM
Day         : 7
DayOfWeek   : Wednesday
DayOfYear   : 220
Hour        : 10
Kind        : Local
Millisecond : 568
Microsecond : 308
Nanosecond  : 600
Minute      : 34
Month       : 8
Second      : 43
Ticks       : 638586236835683086
TimeOfDay   : 10:34:43.5683086
Year        : 2024
DateTime    : Wednesday, August 7, 2024 10:34:43 AM
Quarter     : Q3


DateTime  : Wednesday, August 7, 2024 10:34:43 AM
DayOfYear : 220
Quarter   : Q3

El primer comando muestra la vista de lista del comando Get-Date, que genera un objeto System.DateTime que representa la fecha actual. El comando usa un operador de canalización (|) para enviar el objeto DateTime al cmdlet Format-List. Dado que el comando Format-List no especifica las propiedades que se van a mostrar en la lista, PowerShell muestra todas las propiedades públicas y no ocultas para el objeto .

El segundo comando usa el cmdlet Update-TypeData para establecer las propiedades de lista predeterminadas para el tipo de System.DateTime. El comando usa el parámetro TypeName para especificar el tipo y el parámetro DefaultDisplayPropertySet para especificar las propiedades predeterminadas de una lista. Las propiedades seleccionadas incluyen la nueva propiedad Quarter script que se agregó en un ejemplo anterior.

El último comando obtiene la fecha actual y la muestra de nuevo en un formato de lista. Solo muestra las propiedades definidas en el comando Update-TypeData, en lugar de la lista completa de propiedades.

Ejemplo 5: Establecer la propiedad en la que se muestra un tipo en formato ancho

En este ejemplo se muestra cómo crear una nueva propiedad de script y usarla como la propiedad predeterminada que se muestra cuando el tipo se pasa al cmdlet Format-Wide.

Get-Command *File* | Format-Wide

Set-AppPackageProvisionedDataFile                            Set-ProvisionedAppPackageDataFile
Set-ProvisionedAppXDataFile                                  Write-FileSystemCache
Write-FileSystemCache                                        Add-PoshGitToProfile
Block-FileShareAccess                                        Clear-FileStorageTier
Close-SmbOpenFile                                            Debug-FileShare
Disable-NetIPHttpsProfile                                    Enable-NetIPHttpsProfile
Get-FileIntegrity                                            Get-FileShare
Get-FileShareAccessControlEntry                              Get-FileStorageTier
Get-NetConnectionProfile                                     Get-NetFirewallHyperVProfile
Get-NetFirewallProfile                                       Get-SmbOpenFile
Get-StorageFileServer                                        Get-SupportedFileSystems
Grant-FileShareAccess                                        New-FileShare
New-NetFirewallHyperVProfile                                 New-ScriptFileInfo
New-ScriptFileInfo                                           New-StorageFileServer
Publish-BCFileContent                                        Remove-FileShare
Remove-NetFirewallHyperVProfile                              Remove-PoshGitFromProfile
Remove-StorageFileServer                                     Repair-FileIntegrity
Revoke-FileShareAccess                                       Set-FileIntegrity
Set-FileShare                                                Set-FileStorageTier
Set-NetConnectionProfile                                     Set-NetFirewallHyperVProfile
Set-NetFirewallProfile                                       Set-StorageBusProfile
Set-StorageFileServer                                        Test-ScriptFileInfo
Test-ScriptFileInfo                                          Unblock-FileShareAccess
Update-ScriptFileInfo                                        Update-ScriptFileInfo
Add-BitsFile                                                 Get-AppLockerFileInformation
Get-FileHash                                                 Get-PSScriptFileInfo
Import-PowerShellDataFile                                    New-FileCatalog
New-PSRoleCapabilityFile                                     New-PSScriptFileInfo
New-PSSessionConfigurationFile                               New-TemporaryFile
Out-File                                                     Set-AppXProvisionedDataFile
Test-FileCatalog                                             Test-PSScriptFileInfo
Test-PSSessionConfigurationFile                              Unblock-File
Update-PSScriptFileInfo                                      FileDialogBroker.exe
FileHistory.exe                                              forfiles.exe
openfiles.exe

$typeDataParams = @{
    TypeName               = 'System.Management.Automation.CommandInfo'
    DefaultDisplayProperty = 'FullyQualifiedName'
    MemberType             = 'ScriptProperty'
    MemberName             = 'FullyQualifiedName'
    Value                  = {
        [OutputType([string])]
        param()

        # For executables, return the path to the application.
        if ($this -is [System.Management.Automation.ApplicationInfo]) {
            return $this.Path
        }

        # For commands defined outside a module, return only the name.
        if ([string]::IsNullOrEmpty($this.ModuleName)) {
            return $this.Name
        }

        # Return the fully-qualified command name "<ModuleName>\<CommandName>"
        return '{0}\{1}' -f $this.ModuleName, $this.Name
    }
}
Update-TypeData @typeDataParams

Get-Command *File* | Format-Wide

Dism\Set-AppPackageProvisionedDataFile                       Dism\Set-ProvisionedAppPackageDataFile
Dism\Set-ProvisionedAppXDataFile                             Storage\Write-FileSystemCache
VMDirectStorage\Write-FileSystemCache                        posh-git\Add-PoshGitToProfile
Storage\Block-FileShareAccess                                Storage\Clear-FileStorageTier
SmbShare\Close-SmbOpenFile                                   Storage\Debug-FileShare
NetworkTransition\Disable-NetIPHttpsProfile                  NetworkTransition\Enable-NetIPHttpsProfile
Storage\Get-FileIntegrity                                    Storage\Get-FileShare
Storage\Get-FileShareAccessControlEntry                      Storage\Get-FileStorageTier
NetConnection\Get-NetConnectionProfile                       NetSecurity\Get-NetFirewallHyperVProfile
NetSecurity\Get-NetFirewallProfile                           SmbShare\Get-SmbOpenFile
Storage\Get-StorageFileServer                                Storage\Get-SupportedFileSystems
Storage\Grant-FileShareAccess                                Storage\New-FileShare
NetSecurity\New-NetFirewallHyperVProfile                     PowerShellGet\New-ScriptFileInfo
PowerShellGet\New-ScriptFileInfo                             Storage\New-StorageFileServer
BranchCache\Publish-BCFileContent                            Storage\Remove-FileShare
NetSecurity\Remove-NetFirewallHyperVProfile                  posh-git\Remove-PoshGitFromProfile
Storage\Remove-StorageFileServer                             Storage\Repair-FileIntegrity
Storage\Revoke-FileShareAccess                               Storage\Set-FileIntegrity
Storage\Set-FileShare                                        Storage\Set-FileStorageTier
NetConnection\Set-NetConnectionProfile                       NetSecurity\Set-NetFirewallHyperVProfile
NetSecurity\Set-NetFirewallProfile                           StorageBusCache\Set-StorageBusProfile
Storage\Set-StorageFileServer                                PowerShellGet\Test-ScriptFileInfo
PowerShellGet\Test-ScriptFileInfo                            Storage\Unblock-FileShareAccess
PowerShellGet\Update-ScriptFileInfo                          PowerShellGet\Update-ScriptFileInfo
BitsTransfer\Add-BitsFile                                    AppLocker\Get-AppLockerFileInformation
Microsoft.PowerShell.Utility\Get-FileHash                    Microsoft.PowerShell.PSResourceGet\Get-PSScriptFileInfo
Microsoft.PowerShell.Utility\Import-PowerShellDataFile       Microsoft.PowerShell.Security\New-FileCatalog
Microsoft.PowerShell.Core\New-PSRoleCapabilityFile           Microsoft.PowerShell.PSResourceGet\New-PSScriptFileInfo
Microsoft.PowerShell.Core\New-PSSessionConfigurationFile     Microsoft.PowerShell.Utility\New-TemporaryFile
Microsoft.PowerShell.Utility\Out-File                        Dism\Set-AppXProvisionedDataFile
Microsoft.PowerShell.Security\Test-FileCatalog               Microsoft.PowerShell.PSResourceGet\Test-PSScriptFileInfo
Microsoft.PowerShell.Core\Test-PSSessionConfigurationFile    Microsoft.PowerShell.Utility\Unblock-File
Microsoft.PowerShell.PSResourceGet\Update-PSScriptFileInfo   C:\WINDOWS\system32\FileDialogBroker.exe
C:\WINDOWS\system32\FileHistory.exe                          C:\WINDOWS\system32\forfiles.exe
C:\WINDOWS\system32\openfiles.exe

El primer comando usa el cmdlet Get-Command para devolver cada comando con un nombre que contenga la palabra File. Canaliza la salida al cmdlet Format-Wide, que muestra los nombres de los comandos en columnas.

A continuación, en el ejemplo se usa Update-TypeData para definir tanto el DefaultDisplayProperty de como una nueva propiedad de script para el tipo CommandInfo de. La salida de Get-Command devuelve CommandInfo objetos y objetos derivados de ese tipo. La nueva propiedad de script, FullyQualifiedName, devuelve la ruta de acceso completa a las aplicaciones ejecutables y el nombre completo de los cmdlets, que prefijo el nombre del cmdlet con el módulo que lo define. El cmdlet Update-TypeData puede definir la nueva propiedad de script y usarla como DefaultDisplayProperty en el mismo comando.

Por último, la salida muestra los resultados de la Get-Command se muestran en formato ancho después de la actualización del tipo. Muestra el nombre completo de los cmdlets y la ruta de acceso completa a las aplicaciones ejecutables.

Ejemplo 6: Actualización de datos de tipo para un objeto canalización

$typeDataParams = @{
    MemberType = 'ScriptProperty'
    MemberName = 'SupportsUpdatableHelp'
    Value      = {
        [OutputType([bool])]
        param()

        return (-not [string]::IsNullOrEmpty($this.HelpInfoUri))
    }
}
Get-Module Microsoft.PowerShell.Utility | Update-TypeData @typeDataParams

Get-Module -ListAvailable -Name Microsoft.PowerShell.* |
    Format-Table Name, SupportsUpdatableHelp

Name                                      SupportsUpdatableHelp
----                                      ---------------------
Microsoft.PowerShell.Archive                               True
Microsoft.PowerShell.Diagnostics                           True
Microsoft.PowerShell.Host                                  True
Microsoft.PowerShell.Management                            True
Microsoft.PowerShell.PSResourceGet                         True
Microsoft.PowerShell.Security                              True
Microsoft.PowerShell.Utility                               True
Microsoft.PowerShell.Operation.Validation                  True
Microsoft.PowerShell.LocalAccounts                         True

En este ejemplo se muestra que cuando canaliza un objeto a Update-TypeData, Update-TypeData agrega datos de tipo extendido para el tipo de objeto.

Esta técnica es más rápida que usar el cmdlet Get-Member o el método Get-Type para obtener el tipo de objeto. Sin embargo, si canaliza una colección de objetos a Update-TypeData, actualiza los datos de tipo del primer tipo de objeto y, a continuación, devuelve un error para todos los demás objetos de la colección porque el miembro ya está definido en el tipo.

El primer comando usa el cmdlet Get-Module para obtener el módulo Microsoft.PowerShell.Utility. El comando canaliza el objeto module al cmdlet Update-TypeData, que actualiza los datos de tipo para el tipo System.Management.Automation.PSModuleInfo y los tipos derivados de él, como el tipo ModuleInfoGrouping que Get-Module devuelve cuando se usa el parámetro ListAvailable en el comando.

Los comandos Update-TypeData agregan la propiedad SupportsUpdatableHelp script a todos los módulos importados. El valor del parámetro Value es un script que devuelve $true si la propiedad HelpInfoUri del módulo se rellena y $false de lo contrario.

El segundo comando canaliza los objetos de módulo de Get-Module al cmdlet Format-Table, que muestra las propiedades Name y SupportsUpdatableHelp de los módulos disponibles.

Parámetros

-AppendPath

Especifica la ruta de acceso a los archivos opcionales de .ps1xml. Los archivos especificados se cargan en el orden en que aparecen después de cargar los archivos integrados. También puede canalizar un valor de AppendPath a Update-TypeData.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:PSPath, Ruta

Conjuntos de parámetros

FileSet
Posición:0
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

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

-DefaultDisplayProperty

Especifica la propiedad del tipo que muestra el cmdlet Format-Wide cuando no se especifican otras propiedades.

Escriba el nombre de una propiedad estándar o extendida del tipo. El valor de este parámetro puede ser el nombre de un tipo que se agrega en el mismo comando.

Este valor solo es efectivo cuando no hay vistas amplias definidas para el tipo en un archivo Format.ps1xml.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-DefaultDisplayPropertySet

Especifica una o varias propiedades del tipo. Estas propiedades se muestran mediante los cmdlets Format-List, Format-Tabley Format-Custom cuando no se especifica ninguna otra propiedad.

Escriba los nombres de las propiedades estándar o extendidas del tipo. El valor de este parámetro puede ser los nombres de los tipos que se agregan en el mismo comando.

Este valor solo es efectivo cuando no hay ninguna lista, tabla o vistas personalizadas, respectivamente, definidas para el tipo en un archivo Format.ps1xml.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-DefaultKeyPropertySet

Especifica una o varias propiedades del tipo. Estos cmdlets de Group-Object y Sort-Object usan estas propiedades cuando no se especifica ninguna otra propiedad.

Escriba los nombres de las propiedades estándar o extendidas del tipo. El valor de este parámetro puede ser los nombres de los tipos que se agregan en el mismo comando.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-Force

Indica que el cmdlet usa los datos de tipo especificados, incluso si ya se han especificado datos de tipo para ese tipo.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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
TypeDataSet
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

-InheritPropertySerializationSet

Indica si se hereda el conjunto de propiedades serializadas. El valor predeterminado es $null. Los valores aceptables para este parámetro son:

  • $true. El conjunto de propiedades se hereda.
  • $false. El conjunto de propiedades no se hereda.
  • $null. No se define la herencia.

Este parámetro solo es válido cuando el valor del parámetro SerializationMethod es SpecificProperties. Cuando el valor de este parámetro es $false, se requiere el parámetro PropertySerializationSet.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:

Nullable<T>[Boolean]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-MemberName

Especifica el nombre de una propiedad o método.

Use este parámetro con los parámetros TypeName, MemberType, Value y SecondValue para agregar o cambiar una propiedad o método de un tipo.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-MemberType

Especifica el tipo del miembro que se va a agregar o cambiar.

Use este parámetro con los parámetros TypeName, MemberType, Value y SecondValue para agregar o cambiar una propiedad o método de un tipo. Los valores aceptables para este parámetro son:

  • AliasProperty
  • CodeMethod
  • CodeProperty
  • Propiedad note
  • ScriptMethod
  • ScriptProperty

Para obtener información sobre estos valores, vea enumeración PSMemberTypes.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:PSMemberTypes
Valor predeterminado:None
Valores aceptados:NoteProperty, AliasProperty, ScriptProperty, CodeProperty, ScriptMethod, CodeMethod
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-PrependPath

Especifica la ruta de acceso a los archivos opcionales de .ps1xml. Los archivos especificados se cargan en el orden en que se enumeran antes de que se carguen los archivos integrados.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FileSet
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

-PropertySerializationSet

Especifica los nombres de las propiedades que se serializan. Use este parámetro cuando el valor del parámetro SerializationMethod sea SpecificProperties.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-SecondValue

Especifica valores adicionales para AliasProperty, miembrosScriptProperty , CodePropertyo CodeMethod.

Use este parámetro con los parámetros TypeName, MemberType, Valuey SecondValue parámetros para agregar o cambiar una propiedad o método de un tipo.

Cuando el valor del parámetro MemberType es AliasProperty, el valor del parámetro SecondValue debe ser un tipo de datos. PowerShell convierte (es decir, convierte) el valor de la propiedad alias en el tipo especificado. Por ejemplo, si agrega una propiedad de alias que proporciona un nombre alternativo para una propiedad de cadena, también puede especificar un SecondValue de System.Int32 convertir el valor de cadena con alias en un entero.

Cuando el valor del parámetro MemberType es ScriptProperty, puede usar el parámetro SecondValue para especificar un bloque de script adicional. El bloque de script en el valor del parámetro Value obtiene el valor de una variable. El bloque de script en el valor del parámetro SecondValue establece el valor de la variable.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:Object
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-SerializationDepth

Especifica cuántos niveles de objetos de tipo se serializan como cadenas. El valor predeterminado 1 serializa el objeto y sus propiedades. Un valor de 0 serializa el objeto, pero no sus propiedades. Valor de 2 serializa el objeto, sus propiedades y los objetos de los valores de propiedad.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:1
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-SerializationMethod

Especifica un método de serialización para el tipo . Un método de serialización determina qué propiedades del tipo se serializan y la técnica que se usa para serializarlas. Los valores aceptables para este parámetro son:

  • AllPublicProperties. Serialice todas las propiedades públicas del tipo. Puede usar el parámetro SerializationDepth para determinar si se serializan las propiedades secundarias.
  • String. Serialice el tipo como una cadena. Puede usar el StringSerializationSource para especificar una propiedad del tipo que se va a usar como resultado de la serialización. De lo contrario, el tipo se serializa mediante el método ToString del objeto .
  • SpecificProperties. Serialice solo las propiedades especificadas de este tipo. Use el parámetro PropertySerializationSet para especificar las propiedades del tipo que se serializan. También puede usar el parámetro InheritPropertySerializationSet para determinar si el conjunto de propiedades se hereda y el parámetro SerializationDepth para determinar si se serializan las propiedades secundarias.

En PowerShell, los métodos de serialización se almacenan en PSStandardMembers objetos internos.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-StringSerializationSource

Especifica el nombre de una propiedad del tipo. El valor de la propiedad especificada se usa como resultado de la serialización. Este parámetro solo es válido cuando el valor del parámetro SerializationMethod es String.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-TargetTypeForDeserialization

Especifica el tipo al que se convierte el objeto de este tipo cuando se deserializan.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:Type
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-TypeAdapter

Especifica el tipo de un adaptador de tipo, como Microsoft.PowerShell.Cim.CimInstanceAdapter. Un adaptador de tipo permite a PowerShell obtener los miembros de un tipo.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:Type
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-TypeConverter

Especifica un convertidor de tipos para convertir valores entre distintos tipos. Si se define un convertidor de tipos para un tipo, se usa una instancia del convertidor de tipos para la conversión.

Escriba un valor de System.Type que se deriva de las clases de System.ComponentModel.TypeConvert er o System.Management.Automation.PSTypeConverter.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:Type
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-TypeData

Especifica una matriz de datos de tipo que este cmdlet agrega a la sesión. Escriba una variable que contenga un objeto TypeData o un comando que obtenga un objeto typeData , como un comando Get-TypeData. También puede canalizar un objeto TypeData de para Update-TypeData.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:

TypeData[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TypeDataSet
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-TypeName

Especifica el nombre del tipo que se va a extender.

En el caso de los tipos del espacio de nombres de System, escriba el nombre corto. De lo contrario, se requiere el nombre de tipo completo. No se admiten caracteres comodín.

Puede canalizar nombres de tipo a Update-TypeData. Cuando canaliza un objeto a Update-TypeData, Update-TypeData obtiene el nombre de tipo del objeto y los datos de tipo al tipo de objeto.

Use este parámetro con los parámetros MemberName, MemberType, Value y SecondValue para agregar o cambiar una propiedad o método de un tipo.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Value

Especifica el valor de la propiedad o método.

Si agrega un miembro AliasProperty, CodeProperty, ScriptPropertyo CodeMethod, puede usar el parámetro SecondValue para agregar información adicional.

Use este parámetro con los parámetros MemberName, MemberType, Value y SecondValue para agregar o cambiar una propiedad o método de un tipo.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades del parámetro

Tipo:Object
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DynamicTypeSet
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

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

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

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

String

Puede canalizar una cadena que contenga los valores de los parámetros AppendPath, TypeNameo TypeData a este cmdlet.

Salidas

None

Este cmdlet no devuelve ninguna salida.