Eliminar-TypeData (Microsoft.PowerShell.Utility)

Remove-TypeData

Módulo:

Microsoft.PowerShell.Utility

Elimina tipos extendidos de la sesión actual.

Sintaxis

Remove-TypeData
      -TypeData <TypeData>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

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

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

Descripción

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

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

Este cmdlet se introdujo en Windows PowerShell 3.0.

Ejemplos

Ejemplo 1: eliminar datos de tipo para un tipo específico

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

Remove-TypeData -TypeName System.Array

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

Este ejemplo muestra el efecto de eliminar datos de tipo extendido de una sesión. El primer Get-TypeData obtiene datos de tipo extendido para el tipo System.DateTime. El resultado muestra que se ha agregado una propiedad DateTime a todos los objetos System.DateTime en PowerShell. El cmdlet Get-Date devuelve un objeto System.DateTime. El comando utiliza notación de puntos para obtener el valor de la propiedad DateTime del objeto System.DateTime que devuelve Get-Date.

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 cmdlet Get-TypeData obtiene todos los datos de tipo extendido para el tipo System.DateTime y los canaliza al cmdlet Remove-TypeData para eliminarlos. los datos de tipo extendido. El último cmdlet Get-Date muestra el efecto de eliminar los datos de tipo extendido para el tipo System.DateTime. Debido a que la propiedad System.DateTime ya no existe, un comando para obtener su valor no devuelve nada.

Ejemplo 3: eliminar tipos extendidos para módulos

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

Get-Module | Remove-TypeData

Ejemplo 4: eliminar tipos extendidos de módulos específicos

Este ejemplo utiliza el parámetro Path del cmdlet Remove-TypeData para eliminar los tipos extendidos que se definen en los archivos Types.ps1xml que se agregan. por los módulos PSScheduledJob y PSWorkflow. Este comando no afecta los datos de tipo dinámico que se agregan mediante el cmdlet Update-TypeData. El comando tiene éxito solo cuando los módulos se han importado a 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: eliminar tipos extendidos de una sesión remota

Este ejemplo elimina tipos extendidos de una sesión remota. El comando utiliza el cmdlet Invoke-Command para eliminar datos de tipo extendido para todos los tipos de CIM en las sesiones en la variable $S.

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

Parámetros

-Confirm

Le solicita confirmación antes de ejecutar el cmdlet.

Tipo :

SwitchParameter

Alias:

cf

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Path

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

Introduzca las rutas y los nombres de archivo de uno o más archivos Types.ps1xml. No se admiten comodines. Si omite la ruta, la ubicación predeterminada es el directorio actual.

Tipo :

String[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-TypeData

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

Tipo :

TypeData

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-TypeName

Especifica los tipos para los que este cmdlet elimina todos los datos de tipo extendido. Para los tipos en el espacio de nombres del sistema, ingrese el nombre corto. De lo contrario, se requiere el nombre completo del tipo. No se admiten comodines.

Puede canalizar nombres de tipos a Remove-TypeData. Cuando canaliza un objeto a Remove-TypeData, Remove-TypeData obtiene el nombre del tipo del objeto y elimina todos los datos del tipo de objeto.

Tipo :

String

Posición:

0

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-WhatIf

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

Tipo :

SwitchParameter

Alias:

wi

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Tipo de datos

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

Cadena

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

Salidas

Ninguno

Este cmdlet no devuelve ningún resultado.

Notas

Remove-TypeData puede eliminar solo los datos de tipo extendido en la sesión actual. No puede eliminar datos de tipo extendido que están en la computadora, pero que no se han agregado a la sesión actual, como los tipos extendidos que están definidos en módulos que no se han importado a la sesión actual.