Udostępnij za pomocą


Get-TypeData

Pobiera dane typu rozszerzonego w bieżącej sesji.

Składnia

Default (Domyślna)

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

Opis

Cmdlet Get-TypeData pobiera dane typu rozszerzonego w bieżącej sesji. Obejmuje to dane typu dodane do sesji przez plik Types.ps1xml i dane typu dynamicznego, które zostały dodane przy użyciu parametru polecenia cmdlet Update-TypeData.

Możesz użyć danych typu rozszerzonego, które zwraca Get-TypeData, aby zbadać dane typu w sesji i wysłać je do poleceń cmdletów Update-TypeData i Remove-TypeData.

Rozszerzone dane typu dodają właściwości i metody do obiektów w programie PowerShell. Można użyć dodanych właściwości i metod w taki sam sposób, jak właściwości i metody zdefiniowane w typie obiektu. Jednak podczas pisania skryptów należy pamiętać, że dodane właściwości i metody mogą nie być obecne w każdej sesji programu PowerShell.

Aby uzyskać więcej informacji na temat plików Types.ps1xml, zobacz about_Types.ps1xml. Aby uzyskać więcej informacji na temat danych typu dynamicznego, które dodaje polecenie cmdlet Update-TypeData, zobacz Update-TypeData.

To cmdlet zostało wprowadzone w Windows PowerShell 3.0.

Przykłady

Przykład 1: Pobierz wszystkie dane typu rozszerzonego

Przykład ten pobiera wszystkie dane rozszerzonego typu w aktualnej sesji.

Get-TypeData

Przykład 2. Pobieranie danych typu według nazwy

Ten przykład pobiera wszystkie dane typu w bieżącej sesji, których nazwa zaczyna się od "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…

Przykład 3. Pobierz blok skryptu tworzący wartość właściwości

W tym przykładzie pobierany jest blok skryptu, który tworzy wartość właściwości EventID z obiektów EventLogEntry.

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

Przykład 4. Pobieranie bloku skryptu definiującego właściwość określonego obiektu

W tym przykładzie pobiera blok skryptu, który definiuje właściwość DateTime obiektów System.DateTime w programie 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()
}

Polecenie używa cmdletu Get-TypeData w celu pobrania danych typu rozszerzonego dla typu System.DateTime. Polecenie pobiera właściwość Members obiektu TypeData.

Właściwość Members zawiera tabelę skrótów właściwości i metod zdefiniowanych przez dane typu rozszerzonego. Każdy klucz w tabeli skrótów Członków jest nazwą właściwości lub metody, a każda wartość jest definicją właściwości lub wartości metody.

Polecenie pobiera klucz DateTime w Członkach oraz wartość właściwości GetScriptBlock.

Dane wyjściowe pokazują blok skryptu, który tworzy wartość właściwości DateTime każdego obiektu System.DateTime w programie PowerShell.

Parametry

-TypeName

Określa dane typu jako tablicę tylko dla typów o określonych nazwach. Domyślnie Get-TypeData pobiera wszystkie typy podczas sesji.

Wprowadź nazwy typów lub wzorce nazw. Wymagane są pełne nazwy lub wzorce nazw z symbolami wieloznacznymi, nawet w przypadku typów w przestrzeni nazw systemu. Obsługiwane są symbole wieloznaczne, a nazwa parametru TypeName jest opcjonalna. Możesz także przekierować nazwy typów do Get-TypeData.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

(All)
Position:0
Obowiązkowy:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

Poleceniom cmdlet można przekazywać ciągi zawierające nazwy typów.

Dane wyjściowe

TypeData

Uwagi

Get-TypeData pobiera tylko dane typu rozszerzonego w bieżącej sesji. Nie pobiera rozszerzonych danych typu znajdujących się na komputerze, które nie zostały dodane do bieżącej sesji, takich jak typy rozszerzone zdefiniowane w modułach, które nie zostały zaimportowane do bieżącej sesji.