Remove-TypeData
Supprime les types étendus de la session active.
Syntaxe
RemoveTypeDataSet (Par défaut)
Remove-TypeData
-TypeData <TypeData>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveTypeSet
Remove-TypeData
[-TypeName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveFileSet
Remove-TypeData
-Path <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet Remove-TypeData de commande supprime les données de type étendu de la session active. Cette applet de commande affecte uniquement la session et les sessions actuelles créées dans la session active.
Vous pouvez ajouter des propriétés et des méthodes à des objets dans PowerShell en les définissant dans Update-TypeData des commandes et Types.ps1xml des fichiers.
Remove-TypeData supprime ces propriétés et méthodes étendues de la session active.
Remove-TypeData ne supprime pas les Types.ps1xml fichiers ni ne supprime aucune définition de type étendue des Types.ps1xml fichiers. 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.
Exemples
Exemple 1 : Supprimer des données de type pour un type spécifié
Cet exemple supprime toutes les données de type pour le type System.Array de la session, y compris les données de type ajoutées par un Types.ps1xml fichier et des données de type dynamique ajoutées à la session à l’aide de l’applet Update-TypeData de commande.
Remove-TypeData -TypeName System.Array
Exemple 2 : Supprimer un type de données étendu d’une session
Cet exemple montre l’effet de la suppression des données de type étendu d’une session. La première Get-TypeData obtient les données de type étendu 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 Get-Date de commande 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 qui Get-Date retourne.
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
Applet de commande suivante Get-TypeData pour obtenir toutes les données de type étendu pour le type System.DateTime et les canaux vers l’applet Remove-TypeData de commande pour supprimer les données de type étendu. La dernière Get-Date applet de commande affiche 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.
Exemple 3 : Supprimer des types étendus pour les modules
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
Exemple 4 : Supprimer les types étendus des modules spécifiés
Cet exemple utilise le paramètre Path de l’applet Remove-TypeData de commande pour supprimer les types étendus définis dans les Types.ps1xml fichiers ajoutés par les modules PSScheduledJob et PSWorkflow . Cette commande n’affecte pas les données de type dynamique ajoutées à l’aide de l’applet de Update-TypeData commande. 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.
Exemple 5 : Supprimer des types étendus d’une session distante
Cet exemple supprime les types étendus d’une session distante. La commande utilise l’applet Invoke-Command de commande pour supprimer les données de type étendu pour tous les types CIM dans les sessions de la $S variable.
Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}
Paramètres
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Path
Spécifie un tableau de fichiers que cette applet de commande supprime des données de type étendu de session. Ce paramètre est obligatoire.
Entrez les chemins d’accès et les noms de fichiers d’un ou plusieurs Types.ps1xml fichiers. Les caractères génériques ne sont pas pris en charge. Si vous omettez le chemin d’accès, l’emplacement par défaut est le répertoire actif.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
RemoveFileSet
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TypeData
Spécifie les données de type que cette applet de commande supprime de la session. Ce paramètre est obligatoire. Entrez une variable qui contient des objets TypeData (System.Management.Automation.Runspaces.TypeData) ou une commande qui obtient des objets TypeData , comme une Get-TypeData commande. Vous pouvez également diriger des objets TypeData vers Remove-TypeData.
Propriétés du paramètre
| Type: | TypeData |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
RemoveTypeDataSet
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TypeName
Spécifie les types dont cette applet de commande supprime toutes les données de type étendues. Pour les types dans l’espace de noms Système, entrez le nom court. Sinon, le nom de type complet est obligatoire. Les caractères génériques ne sont pas pris en charge.
Vous pouvez envoyer des noms de type à Remove-TypeData via le pipeline. Lorsque vous dirigez un objet vers Remove-TypeData, Remove-TypeData obtient le nom de type de l’objet et supprime toutes les données de type pour le type d’objet.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
RemoveTypeSet
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
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.
Entrées
TypeData
Vous pouvez diriger un objet TypeData , tel que celui retourné par l’applet Get-TypeData de commande, vers cette applet de commande.
String
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.
Sorties
None
Cette applet de commande ne retourne aucune sortie.
Notes
Remove-TypeData peut supprimer uniquement les données de type étendu dans la session active. 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.
