Remove-TypeData
Elimina los tipos extendidos de la sesión actual.
Sintaxis
RemoveTypeDataSet (Es el valor predeterminado).
Remove-TypeData
-TypeData <TypeData>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveTypeSet
Remove-TypeData
[-TypeName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveFileSet
Remove-TypeData
-Path <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Remove-TypeData elimina los datos de tipo extendido de la sesión actual. Este cmdlet afecta solo a la sesión y las sesiones actuales que se crean en la sesión actual.
Puede agregar propiedades y métodos a objetos en PowerShell definiéndolas 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 de Types.ps1xml ni elimina ninguna definición de tipo extendido de los archivos de Types.ps1xml. Para obtener más información sobre los archivos de Types.ps1xml, vea 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 para el tipo de System.Array de de la sesión, incluidos los datos de tipo agregados por un archivo de 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: 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. El primer Get-TypeData obtiene datos de tipo extendido para el tipo de System.DateTime de. La salida muestra que se ha agregado una propiedad dateTime a todos los objetos System.DateTime de PowerShell. El cmdlet Get-Date 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 cmdlet Get-TypeData para obtener todos los datos de tipo extendido para el tipo de System.DateTime y canaliza el tipo de Remove-TypeData para eliminar los datos de tipo extendido. El último cmdlet de Get-Date muestra el efecto de eliminar los datos de tipo extendido del 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 cmdlet Remove-TypeData para quitar los tipos extendidos definidos en los archivos de Types.ps1xml agregados por el PSScheduledJob y módulos de PSWorkflow. Este comando no afecta a los datos de tipo dinámico que se agregan mediante el cmdlet Update-TypeData. El comando solo se realiza correctamente cuando 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 cmdlet Invoke-Command para quitar datos de tipo extendido para todos los tipos CIM de las sesiones de la variable $S.
Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}
Parámetros
-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 |
-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 archivos Types.ps1xml. No se admiten caracteres comodín. Si omite la ruta de acceso, la ubicación predeterminada es el directorio actual.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
RemoveFileSet
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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 comando Get-TypeData. También puede canalizar objetos TypeData a Remove-TypeData.
Propiedades del parámetro
| Tipo: | TypeData |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
RemoveTypeDataSet
| 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 |
-TypeName
Especifica los tipos para los que este cmdlet elimina todos los datos de tipo extendido. En el caso de los tipos del espacio de nombres Del sistema, 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
RemoveTypeSet
| 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 |
-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
TypeData
Puede canalizar un objeto TypeData, como los que devuelve el cmdlet Get-TypeData, 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 ninguna salida.
Notas
Remove-TypeData solo puede quitar los datos de tipo extendido en la sesión actual. No se pueden quitar los datos de tipo extendido que se encuentran en el equipo, pero no se han agregado a la sesión actual, como los tipos extendidos definidos en módulos que no se han importado en la sesión actual.
