Partager via

Get-TypeData

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

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

Syntaxe

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

Description

L’applet Get-TypeData de commande 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 Update-TypeData de commande.

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 et Remove-TypeData aux Update-TypeData applets de commande.

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 les méthodes ajoutées de la même manière que vous utiliseriez les propriétés et les méthodes qui sont 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 Types.ps1xml fichiers, consultez about_Types.ps1xml. Pour plus d’informations sur les données de type dynamique que l’applet Update-TypeData de commande 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é DateTime des objets 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 Get-TypeData de commande 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é dans la table de hachage Members est un nom de propriété ou de méthode et chaque valeur est la définition de la valeur de propriété ou de méthode.

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

La sortie affiche 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 types ou des modèles de nom. 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 de paramètre TypeName est facultatif. Vous pouvez également diriger les noms de types vers Get-TypeData.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

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 les données de type étendu sur l'ordinateur, mais n'a pas été ajouté à la session active, comme les types étendus qui sont définis dans les modules qui n'ont pas été importés dans la session active.