Get-TypeData

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Ruft die erweiterten Typdaten in der aktuellen Sitzung ab.

Syntax

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

Beschreibung

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

Sie können die erweiterten Typdaten verwenden, die zurückgegeben werden, Get-TypeData um die Typdaten in der Sitzung zu untersuchen und an die Update-TypeData Cmdlets 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 wie die im Objekttyp definierten Eigenschaften und Methoden verwenden. 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 das Update-TypeData Cmdlet hinzufügt, 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 Get-TypeData Cmdlet, um die erweiterten Typdaten für den System.DataTime-Typ abzurufen. Der Befehl ruft die Members-Eigenschaft des TypeData-Objekts ab.

Die Members-Eigenschaft enthält eine Hashtabelle mit Eigenschaften und Methoden, die durch erweiterte Typdaten definiert werden. Jeder Schlüssel in der Hashtabelle „Members“ ist ein Eigenschaften- oder Methodenname, und jeder Wert ist die Definition des Eigenschaften- 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. Ruft standardmäßig Get-TypeData alle Typen in der Sitzung ab.

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 ruft keine erweiterten Typdaten ab, die sich auf dem Computer befinden, aber nicht der aktuellen Sitzung hinzugefügt wurden, wie z. B. erweiterte Typen, die in Modulen definiert und nicht in die aktuelle Sitzung importiert wurden.