Remove-TypeData

  • Référence
Module:
Microsoft.PowerShell.Utility

Supprime les types étendus de la session active.

Syntax

Remove-TypeData
      -TypeData <TypeData>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-TypeData
      [-TypeName] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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 seulement la session active et les sessions qui sont 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 Types.ps1xml fichiers, 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. Cette commande réussit seulement quand 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 demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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

-TypeName

Spécifie les types dont cette applet de commande supprime toutes les données de type étendues. Pour les types de 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 diriger les noms de types vers Remove-TypeData. 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.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

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 pas de 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 qui n'ont pas été ajoutées à la session active, comme des types étendus qui sont définis dans des modules qui n'ont pas été importés dans la session active.