Freigeben über

Get-TypeData

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Ruft die erweiterten Typdaten in der aktuellen Sitzung ab.

Syntax

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

Beschreibung

Das Cmdlet Get-TypeData ruft die erweiterten Typdaten in der aktuellen Sitzung ab. Dazu gehören Typdaten, die der Sitzung durch Types.ps1xml Datei- und dynamische Typdaten hinzugefügt wurden, die mithilfe des Parameters des Cmdlets Update-TypeData hinzugefügt wurden.

Sie können die erweiterten Typdaten verwenden, die Get-TypeData zurückgeben, um die Typdaten in der Sitzung zu untersuchen und an die cmdlets Update-TypeData und Remove-TypeData zu senden.

Erweiterte Typdaten fügen Objekten in PowerShell Eigenschaften und Methoden hinzu. Sie können die hinzugefügten Eigenschaften und Methoden auf die gleiche Weise verwenden wie die Eigenschaften und Methoden, die im Objekttyp definiert sind. Beachten Sie beim Schreiben von Skripts jedoch, dass die hinzugefügten Eigenschaften und Methoden in jeder PowerShell-Sitzung möglicherweise nicht vorhanden sind.

Weitere Informationen zu Types.ps1xml Dateien finden Sie unter about_Types.ps1xml. Weitere Informationen zu dynamischen Typdaten, die vom cmdlet Update-TypeData hinzugefügt werden, finden Sie unter Update-TypeData.

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

Beispiele

Beispiel 1: Abrufen aller erweiterten Typdaten

In diesem Beispiel werden alle erweiterten Typdaten in der aktuellen Sitzung abgerufen.

Get-TypeData

Beispiel 2: Abrufen von Typdaten nach Name

In diesem Beispiel werden alle Typdaten in der aktuellen Sitzung abgerufen, deren Name mit "System.IO" qualifiziert ist.

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…

Beispiel 3: Abrufen des Skriptblocks, der einen Eigenschaftswert erstellt

In diesem Beispiel wird der Skriptblock abgerufen, der den Wert der EventID-eigenschaft von EventLogEntry--Objekten erstellt.

(Get-TypeData *EventLogEntry*).Members.EventID

GetScriptBlock                     SetScriptBlock     IsHidden Name
--------------                     --------------     -------- ----
$this.get_EventID() -band 0xFFFF                         False EventID

Beispiel 4: Abrufen des Skriptblocks, der eine Eigenschaft für ein angegebenes Objekt definiert

In diesem Beispiel wird der Skriptblock aufgerufen, der die DateTime-eigenschaft von System.DateTime--Objekten in PowerShell definiert.

(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()
}

Der Befehl verwendet das Cmdlet Get-TypeData, um die erweiterten Typdaten für den System.DataTime- Typ abzurufen. Der Befehl ruft die eigenschaft Members des TypeData-Objekts ab.

Die eigenschaft Members enthält eine Hashtabelle mit Eigenschaften und Methoden, die durch erweiterte Typdaten definiert werden. Jeder Schlüssel in der Memberhashtabelle ist ein Eigenschafts- oder Methodenname, und jeder Wert ist die Definition des Eigenschafts- oder Methodenwerts.

Der Befehl ruft den DateTime--Schlüssel in Members und dessen GetScriptBlock Eigenschaftswert ab.

Die Ausgabe zeigt den Skriptblock an, der den Wert der DateTime--Eigenschaft jedes System.DateTime--Objekts in PowerShell erstellt.

Parameter

-TypeName

Gibt Typdaten nur für die Typen mit den angegebenen Namen als Array an. Standardmäßig ruft Get-TypeData alle Typen in der Sitzung ab.

Geben Sie Typnamen oder Namensmuster ein. Vollständige Namen oder Namensmuster mit Wildcardzeichen sind erforderlich, auch für Typen im Systemnamespace. Wildcards werden unterstützt, und der Parametername TypeName- optional ist. Sie können auch Namen an Get-TypeDatapipen.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

Eingaben

String

Sie können Zeichenfolgen mit Typnamen an dieses Cmdlet weiterleiten.

Ausgaben

TypeData

Hinweise

Get-TypeData ruft nur die erweiterten Typdaten in der aktuellen Sitzung ab. Es werden keine erweiterten Typdaten abgerufen, die sich auf dem Computer befinden, aber nicht zur aktuellen Sitzung hinzugefügt wurden, z. B. erweiterte Typen, die in Modulen definiert sind, die nicht in die aktuelle Sitzung importiert wurden.