Remove-TypeData

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

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

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

L’applet de commande Remove-TypeData supprime les données de type étendues de la session active. Cette applet de commande affecte uniquement la session en cours et les sessions qui sont créées dans la session en cours.

Vous pouvez ajouter des propriétés et des méthodes à des objets dans PowerShell en les définissant dans Update-TypeData commandes et fichiers Types.ps1xml. Remove-TypeData supprime ces propriétés et méthodes étendues de la session active. Remove-TypeData ne supprime pas les fichiers Types.ps1xml ni supprime les définitions de types étendues des fichiers Types.ps1xml. Pour plus d’informations sur les fichiers Types.ps1xml, consultez about_Types.ps1xml.

Cette applet de commande a été introduite dans Windows PowerShell 3.0.

Cet exemple supprime toutes les données de type pour le type de System.Array de la session, y compris les données de type ajoutées par un fichier Types.ps1xml et des données de type dynamique ajoutées à la session à l’aide de l’applet de commande Update-TypeData.

Remove-TypeData -TypeName System.Array

Cet exemple montre l’effet de la suppression des données de type étendu d’une session. Le premier Get-TypeData obtient les données de type étendues pour le type System.DateTime. La sortie indique qu'une propriété DateTime a été ajoutée à tous les objets System.DateTime dans PowerShell. L’applet de commande Get-Date retourne un objet System.DateTime. La commande utilise la notation par points pour obtenir la valeur de la propriété DateTime de l’objet System.DateTime retourné par 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

L’applet de commande Get-TypeData suivante obtient toutes les données de type étendu pour le type System.DateTime et les transmet à l’applet de commande Remove-TypeData pour supprimer les données de type étendu. Le dernier applet de commande Get-Date montre l’effet de la suppression des données de type étendu pour le type System.DateTime. Étant donné que la propriété System.DateTime n’existe plus, une commande pour obtenir sa valeur ne retourne rien.

Cet exemple supprime toutes les données de type étendu pour les objets de module. Lorsque vous dirigez un objet vers Remove-TypeData, Remove-TypeData obtient le nom du type d’objet et supprime toutes les données de type pour tous les objets de ce type.

Get-Module | Remove-TypeData

Cet exemple utilise le paramètre Path de l’applet de commande pour supprimer les types étendus définis dans les fichiers qui sont ajoutés par le PSScheduledJob et modules PSWorkflow. Cette commande n’affecte pas les données de type dynamique ajoutées à l’aide de l’applet de commande Update-TypeData. La commande réussit uniquement lorsque les modules ont été importés dans la session active.

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

Pour plus d’informations sur les modules, consultez about_Modules.

Cet exemple supprime les types étendus d’une session distante. La commande utilise l’applet de commande Invoke-Command pour supprimer les données de type étendu pour tous les types CIM dans les sessions de la variable $S.

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

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez diriger un objet TypeData, tel que ceux retournés par l’applet de commande Get-TypeData, vers cette applet de commande.

Vous pouvez diriger une chaîne contenant le nom de type vers cette applet de commande. Lorsque vous dirigez un objet vers cette applet de commande, il obtient le nom de type de l’objet et supprime toutes les données de type pour le type d’objet.

Cette applet de commande ne retourne aucune sortie.

Remove-TypeData peut supprimer uniquement les données de type étendu dans la session en cours. Il ne peut pas supprimer les données de type étendu qui se trouvent sur l’ordinateur, mais n’a pas été ajoutée à la session active, comme les types étendus définis dans les modules qui n’ont pas été importés dans la session active.