Udostępnij za pośrednictwem

Get-CimClass

  • Odwołanie
Moduł:
CimCmdlets

Pobiera listę klas MODELU CIM w określonej przestrzeni nazw.

Składnia

Get-CimClass
   [[-ClassName] <string>]
   [[-Namespace] <string>]
   [-Amended]
   [-OperationTimeoutSec <uint>]
   [-ComputerName <string[]>]
   [-MethodName <string>]
   [-PropertyName <string>]
   [-QualifierName <string>]
   [<CommonParameters>]
Get-CimClass
   [[-ClassName] <string>]
   [[-Namespace] <string>]
   -CimSession <CimSession[]>
   [-Amended]
   [-OperationTimeoutSec <uint>]
   [-MethodName <string>]
   [-PropertyName <string>]
   [-QualifierName <string>]
   [<CommonParameters>]

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie Get-CimClass cmdlet pobiera listę klas modelu CIM w określonej przestrzeni nazw. Jeśli nie podano nazwy klasy, polecenie cmdlet zwraca wszystkie klasy w przestrzeni nazw. W przeciwieństwie do wystąpienia modelu CIM klasy modelu CIM nie zawierają nazwy sesji lub komputera, z którego są pobierane.

Przykłady

Przykład 1. Pobieranie wszystkich definicji klas

Ten przykład pobiera wszystkie definicje klas w katalogu głównym/cimv2 przestrzeni nazw.

Get-CimClass

Przykład 2. Pobieranie klas o określonej nazwie

W tym przykładzie klasy, które zawierają wyraz disk w nazwach.

Get-CimClass -ClassName *disk*

Przykład 3. Pobieranie klas o określonej nazwie metody

Ten przykład pobiera klasy rozpoczynające się od nazwy Win32 i mają nazwę metody rozpoczynającą się od terminu.

Get-CimClass -ClassName Win32* -MethodName Term*

Przykład 4. Pobieranie klas o określonej nazwie właściwości

Ten przykład pobiera klasy rozpoczynające się od nazwy Win32 i mają właściwość o nazwie Handle.

Get-CimClass -ClassName Win32* -PropertyName Handle

Przykład 5. Pobieranie klas z określoną nazwą kwalifikatora

W tym przykładzie klasy rozpoczynające się od nazwy Win32 zawierają wyraz Disk w nazwach i mają określone skojarzenie kwalifikatora.

Get-CimClass -ClassName Win32*Disk* -QualifierName Association

Przykład 6. Pobieranie definicji klas z określonej przestrzeni nazw

W tym przykładzie są pobierane definicje klas zawierające słowo Net w nazwach z określonego katalogu głównego/standardCimv2 przestrzeni nazw.

Get-CimClass -Namespace root/standardCimv2 -ClassName *Net*

Przykład 7. Pobieranie definicji klas z serwera zdalnego

Ten przykład pobiera definicje klas, które zawierają wyraz disk w nazwach z określonych serwerów zdalnych Server01 i Server02.

Get-CimClass -ClassName *disk* -ComputerName Server01, Server02

Przykład 8. Pobieranie klas przy użyciu sesji modelu CIM

$s = New-CimSession -ComputerName Server01, Server02
Get-CimClass -ClassName *disk* -CimSession $s

Ten zestaw poleceń tworzy sesję z wieloma komputerami i zapisuje ją w zmiennej $s przy użyciu New-CimSession polecenia cmdlet, a następnie pobiera klasy przy użyciu Get-CimClass polecenia cmdlet .

Parametry

-Amended

Wskazuje, że obiekty zwrócone z zapytania CIM powinny zawierać zmienione informacje. Zazwyczaj zmienione informacje są lokalizowalne, takie jak opisy obiektów i właściwości dołączone do obiektu MODELU CIM. Jest to przydatne w przypadku tłumaczenia wartości liczbowych na wartości czytelne dla człowieka.

Ten parametr został dodany w programie PowerShell 7.3.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-CimSession

Uruchamia polecenie cmdlet w sesji zdalnej lub na komputerze zdalnym. Wprowadź nazwę komputera lub obiekt sesji, taki jak dane wyjściowe New-CimSession polecenia cmdlet lub Get-CimSession . Wartość domyślna to bieżąca sesja na komputerze lokalnym.

Typ:CimSession[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ClassName

Określa nazwę klasy CIM, dla której ma być wykonywana operacja. Aby przeglądać listę klas, można użyć uzupełniania tabulatorów, ponieważ program PowerShell pobiera listę klas z lokalnego serwera WMI, aby podać listę nazw klas.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-ComputerName

Określa komputer, na którym chcesz uruchomić operację CIM. Można określić w pełni kwalifikowaną nazwę domeny (FQDN) nazwę NetBIOS lub adres IP.

Jeśli określisz ten parametr, polecenie cmdlet utworzy sesję tymczasową na określonym komputerze przy użyciu protokołu WsMan.

Jeśli nie określisz tego parametru, polecenie cmdlet wykonuje operację na komputerze lokalnym przy użyciu modelu obiektów składników (COM).

Jeśli na tym samym komputerze jest wykonywanych wiele operacji, użycie sesji modelu CIM zapewnia lepszą wydajność.

Typ:String[]
Aliasy:CN, ServerName
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-MethodName

Znajduje klasy, które mają metodę zgodną z tą nazwą. Można użyć symboli wieloznacznych z tym parametrem.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-Namespace

Określa przestrzeń nazw dla operacji CIM. Domyślna przestrzeń nazw to root/cimv2. Za pomocą uzupełniania karty można przeglądać listę przestrzeni nazw, ponieważ program PowerShell pobiera listę przestrzeni nazw z lokalnego serwera WMI w celu udostępnienia listy przestrzeni nazw.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-OperationTimeoutSec

Określa czas oczekiwania polecenia cmdlet na odpowiedź z komputera. Domyślnie wartość tego parametru to 0, co oznacza, że polecenie cmdlet używa domyślnej wartości limitu czasu dla serwera.

Jeśli parametr OperationTimeoutSec jest ustawiony na wartość mniejszą niż limit czasu ponawiania próby niezawodnego połączenia przez 3 minuty, awarie sieci, które trwają dłużej niż wartość parametru OperationTimeoutSec, nie są możliwe do odzyskania, ponieważ operacja na serwerze przekracza limit czasu, zanim klient będzie mógł ponownie nawiązać połączenie.

Typ:UInt32
Aliasy:OT
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PropertyName

Znajduje klasy, które mają właściwość zgodną z tą nazwą. Można użyć symboli wieloznacznych z tym parametrem.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-QualifierName

Filtruje klasy według nazwy kwalifikatora na poziomie klasy. Można użyć symboli wieloznacznych z tym parametrem.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

CimClass

To polecenie cmdlet zwraca obiekt klasy CIM.

Uwagi

Program PowerShell zawiera następujące aliasy dla programu Get-CimClass:

  • Windows:
    • gcls

To polecenie cmdlet jest dostępne tylko na platformach windows.