Remove-TypeData

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Elimina los tipos extendidos de la sesión actual.

Syntax

Remove-TypeData
      -TypeData <TypeData>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-TypeData
      [-TypeName] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-TypeData
      -Path <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El Remove-TypeData cmdlet elimina los datos de tipo extendido de la sesión actual. Este cmdlet solo afecta a la sesión actual y a las sesiones que se crean en ella.

Puede agregar propiedades y métodos a objetos en PowerShell definiéndolas en Update-TypeData comandos y Types.ps1xml archivos. Remove-TypeData elimina esas propiedades y métodos extendidos de la sesión actual. Remove-TypeData no elimina los Types.ps1xml archivos ni elimina ninguna definición de tipo extendido de los Types.ps1xml archivos. Para obtener más información sobre Types.ps1xml los archivos, consulte about_Types.ps1xml.

Este cmdlet se introdujo en Windows PowerShell 3.0.

Ejemplos

Ejemplo 1: Eliminación de datos de tipo para un tipo especificado

En este ejemplo se eliminan todos los datos de tipo del tipo System.Array de la sesión, incluidos los datos de tipo agregados por un Types.ps1xml archivo y los datos de tipo dinámico que se agregaron a la sesión mediante el Update-TypeData cmdlet .

Remove-TypeData -TypeName System.Array

Ejemplo 2: Quitar un tipo de datos extendido de una sesión

En este ejemplo se muestra el efecto de quitar datos de tipo extendido de una sesión. La primera Get-TypeData obtiene datos de tipo extendido para el tipo System.DateTime . La salida muestra que se ha agregado una propiedad DateTime a todos los objetos System.DateTime de PowerShell. El Get-Date cmdlet devuelve un objeto System.DateTime . El comando usa la notación de puntos para obtener el valor de la propiedad DateTime del objeto System.DateTime que Get-Date devuelve.

Get-TypeData System.DateTime
(Get-Date).DateTime
Get-TypeData System.DateTime | Remove-TypeData
(Get-Date).DateTime

TypeName        Members
--------        -------
System.DateTime {[DateTime, System.Management.Automation.Runspaces.ScriptPropertyData]}

Friday, January 20, 2012 9:01:00 PM

El siguiente Get-TypeData cmdlet para obtener todos los datos de tipo extendido para el tipo System.DateTime y canaliza el Remove-TypeData cmdlet para eliminar los datos de tipo extendido. El último Get-Date cmdlet muestra el efecto de eliminar los datos de tipo extendido para el tipo System.DateTime . Dado que la propiedad System.DateTime ya no existe, un comando para obtener su valor no devuelve nada.

Ejemplo 3: Eliminación de tipos extendidos para módulos

En este ejemplo se quitan todos los datos de tipo extendido para los objetos de módulo. Cuando canaliza un objeto a Remove-TypeData, Remove-TypeData obtiene el nombre del tipo de objeto y quita todos los datos de tipo para todos los objetos de ese tipo.

Get-Module | Remove-TypeData

Ejemplo 4: Eliminación de tipos extendidos de módulos especificados

En este ejemplo se usa el parámetro Path del Remove-TypeData cmdlet para quitar los tipos extendidos definidos en los Types.ps1xml archivos agregados por los módulos PSScheduledJob y PSWorkflow . Este comando no afecta a los datos de tipo dinámico que se agregan mediante el Update-TypeData cmdlet . El comando únicamente tiene éxito si los módulos se han importado en la sesión actual.

Remove-TypeData -Path "$PSHOME\Modules\PSScheduledJob", "$PSHOME\Modules\PSWorkflow\PSWorkflow.types.ps1xml"

Para obtener más información sobre los módulos, consulte about_Modules.

Ejemplo 5: Eliminación de tipos extendidos de una sesión remota

En este ejemplo se quitan los tipos extendidos de una sesión remota. El comando usa el Invoke-Command cmdlet para quitar datos de tipo extendido para todos los tipos CIM de las sesiones de la $S variable .

Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Especifica una matriz de archivos que este cmdlet elimina de los datos de tipo extendido de sesión. Este parámetro es obligatorio.

Escriba las rutas de acceso y los nombres de archivo de uno o varios Types.ps1xml archivos. No se admiten caracteres comodín. Si se omite la ruta de acceso, la ubicación predeterminada es el directorio actual.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TypeData

Especifica los datos de tipo que este cmdlet elimina de la sesión. Este parámetro es obligatorio. Escriba una variable que contenga objetos TypeData (System.Management.Automation.Runspaces.TypeData) o un comando que obtiene objetos TypeData, como un Get-TypeData comando. También puede canalizar objetos TypeData a Remove-TypeData.

Type:TypeData
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TypeName

Especifica los tipos para los que este cmdlet elimina todos los datos de tipo extendido. Para los tipos del espacio de nombres 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 Remove-TypeData. Cuando canaliza un objeto a Remove-TypeData, Remove-TypeData obtiene el nombre de tipo del objeto y quita todos los datos de tipo para el tipo de objeto.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

TypeData

Puede canalizar un objeto TypeData , como los que devuelve el Get-TypeData cmdlet, a este cmdlet.

String

Puede canalizar una cadena que contenga el nombre de tipo a este cmdlet. Cuando canaliza un objeto a este cmdlet, obtiene el nombre de tipo del objeto y quita todos los datos de tipo para el tipo de objeto.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

Remove-TypeData solo puede quitar los datos de tipo extendido en la sesión actual. Este cmdlet no puede quitar los datos de tipos extendidos que se encuentran en el equipo y que no se han agregado a la sesión actual, como, por ejemplo, los tipos extendidos que se definen en módulos que no se han importado a la sesión actual.