Partager via


Get-TypeData

Obtient les données de type étendu dans la session active.

Syntaxe

Default (Par défaut)

Get-TypeData
    [[-TypeName] <String[]>]
    [<CommonParameters>]

Description

L’applet de commande Get-TypeData obtient les données de type étendu dans la session active. Cela inclut les données de type ajoutées à la session par Types.ps1xml fichier et les données de type dynamique ajoutées à l’aide du paramètre de l’applet de commande Update-TypeData.

Vous pouvez utiliser les données de type étendues qui Get-TypeData retournent pour examiner les données de type dans la session et les envoyer aux applets de commande Update-TypeData et Remove-TypeData.

Les données de type étendue ajoutent des propriétés et des méthodes à des objets dans PowerShell. Vous pouvez utiliser les propriétés et méthodes ajoutées de la même manière que celles définies dans le type d’objet. Toutefois, lors de l’écriture de scripts, sachez que les propriétés et méthodes ajoutées peuvent ne pas être présentes dans chaque session PowerShell.

Pour plus d’informations sur les fichiers Types.ps1xml, consultez about_Types.ps1xml. Pour plus d’informations sur les données de type dynamique que l’applet de commande Update-TypeData ajoute, consultez Update-TypeData.

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

Exemples

Exemple 1 : Obtenir toutes les données de type étendu

Cet exemple obtient toutes les données de type étendu dans la session active.

Get-TypeData

Exemple 2 : Obtenir des données de type par nom

Cet exemple obtient toutes les données de type dans la session active dont le nom est qualifié avec « System.IO ».

Get-TypeData -TypeName System.IO.*
TypeName                Members
--------                -------
System.IO.DirectoryInfo {[Mode, System.Management.Automation.Runspaces.CodePropert…
System.IO.FileInfo      {[Mode, System.Management.Automation.Runspaces.CodePropert…

Exemple 3 : Obtenir le bloc de script qui crée une valeur de propriété

Cet exemple obtient le bloc de script qui crée la valeur de la propriété EventID des objets EventLogEntry.

(Get-TypeData *EventLogEntry*).Members.EventID
GetScriptBlock                     SetScriptBlock     IsHidden Name
--------------                     --------------     -------- ----
$this.get_EventID() -band 0xFFFF                         False EventID

Exemple 4 : Obtenir le bloc de script qui définit une propriété pour un objet spécifié

Cet exemple obtient le bloc de script qui définit la propriété DateTimedes objets System.DateTime system.DateTime dans PowerShell.

(Get-TypeData -TypeName System.DateTime).Members["DateTime"].GetScriptBlock
if ((& { Set-StrictMode -Version 1; $this.DisplayHint }) -ieq  "Date") {
   "{0}" -f $this.ToLongDateString()
}
elseif ((& { Set-StrictMode -Version 1; $this.DisplayHint }) -ieq "Time") {
   "{0}" -f  $this.ToLongTimeString()
}
else {
   "{0} {1}" -f $this.ToLongDateString(), $this.ToLongTimeString()
}

La commande utilise l’applet de commande Get-TypeData pour obtenir les données de type étendu pour le type System.DataTime. La commande obtient la propriété Members de l’objet TypeData.

La propriété Members contient une table de hachage de propriétés et de méthodes définies par des données de type étendues. Chaque clé de la table de hachage Members est un nom de propriété ou de méthode et chaque valeur est la définition de la propriété ou de la valeur de méthode.

La commande obtient la clé DateTime dans Membres et sa valeur de propriété GetScriptBlock .

La sortie montre le bloc de script qui crée la valeur de la propriété DateTime de chaque objet System.DateTime dans PowerShell.

Paramètres

-TypeName

Spécifie les données de type en tant que tableau uniquement pour les types avec les noms spécifiés. Par défaut, Get-TypeData obtient tous les types dans la session.

Entrez des noms de type ou des modèles de noms. Les noms complets ou les modèles de noms avec des caractères génériques sont requis, même pour les types dans l’espace de noms System. Les caractères génériques sont pris en charge et le nom du paramètre TypeName est facultatif. Vous pouvez également diriger des noms de types vers Get-TypeData.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:False
Valeur du pipeline:True
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

String

Vous pouvez diriger des chaînes contenant des noms de types vers cette applet de commande.

Sorties

TypeData

Notes

Get-TypeData obtient uniquement les données de type étendu dans la session active. Il n’obtient pas de 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.