Поделиться через


Get-CimClass

Возвращает список классов CIM в определенном пространстве имен.

Синтаксис

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>]

Описание

Этот командлет доступен только на платформе Windows.

Командлет Get-CimClass извлекает список классов CIM в определенном пространстве имен. Если имя класса не указано, командлет возвращает все классы в пространстве имен. В отличие от экземпляра CIM, классы CIM не содержат имени сеанса или компьютера CIM, из которого они извлекаются.

Примеры

Пример 1. Получение всех определений классов

В этом примере возвращаются все определения классов в корневом или cimv2 пространстве имен.

Get-CimClass

Пример 2. Получение классов с определенным именем

В этом примере получаются классы, содержащие диск слова в их именах.

Get-CimClass -ClassName *disk*

Пример 3. Получение классов с определенным именем метода

В этом примере получаются классы, начинающиеся с имени Win32 , и имя метода, начинающееся с термина.

Get-CimClass -ClassName Win32* -MethodName Term*

Пример 4. Получение классов с определенным именем свойства

В этом примере получаются классы, начинающиеся с имени Win32 и имеющие свойство Handle.

Get-CimClass -ClassName Win32* -PropertyName Handle

Пример 5. Получение классов с определенным именем квалификатора

В этом примере получаются классы, начинающиеся с имени Win32, содержат слово "Диск" в именах и имеют указанную связь квалификатора.

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

Пример 6. Получение определений классов из определенного пространства имен

В этом примере возвращаются определения классов, содержащие слово Net в именах из указанного корневого каталога пространства имен или standardCimv2.

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

Пример 7. Получение определений классов с удаленного сервера

В этом примере возвращаются определения классов, содержащие диск слова в именах из указанных удаленных серверов Server01 и Server02.

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

Пример 8. Получение классов с помощью сеанса CIM

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

Этот набор команд создает сеанс с несколькими компьютерами и сохраняет его в переменную $s с помощью командлета, а затем получает классы с помощью New-CimSession командлета Get-CimClass .

Параметры

-Amended

Указывает, что объекты, возвращаемые из запроса CIM, должны содержать измененные сведения. Как правило, измененная информация является локализуемой информацией, например описания объектов и свойств, присоединенных к объекту CIM. Это полезно для преобразования числовых значений в читаемые для человека значения.

Этот параметр был добавлен в PowerShell 7.3.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CimSession

Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные командлета или Get-CimSession командлетаNew-CimSession. Сеанс по умолчанию — текущий сеанс на локальном компьютере.

Тип:CimSession[]
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ClassName

Указывает имя класса CIM, для которого выполняется операция. Вы можете использовать завершение вкладки для просмотра списка классов, так как PowerShell получает список классов с локального сервера WMI для предоставления списка имен классов.

Тип:String
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-ComputerName

Указывает компьютер, на котором требуется выполнить операцию CIM. Можно указать полное доменное имя (FQDN) имя NetBIOS или IP-адрес.

При указании этого параметра командлет создает временный сеанс для указанного компьютера с помощью протокола WsMan.

Если этот параметр не указан, командлет выполняет операцию на локальном компьютере с помощью объектной модели компонента (COM).

Если несколько операций выполняются на одном компьютере, использование сеанса CIM обеспечивает лучшую производительность.

Тип:String[]
Aliases:CN, ServerName
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-MethodName

Находит классы, имеющие метод, соответствующий этому имени. С этим параметром можно использовать подстановочные знаки.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-Namespace

Указывает пространство имен для операции CIM. Пространство имен по умолчанию — root/cimv2. Вы можете использовать завершение вкладки для просмотра списка пространств имен, так как PowerShell получает список пространств имен с локального сервера WMI для предоставления списка пространств имен.

Тип:String
Position:1
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-OperationTimeoutSec

Указывает время ожидания командлетом ответа от компьютера. По умолчанию значение этого параметра равно 0, что означает, что командлет использует значение времени ожидания по умолчанию для сервера.

Если параметр OperationTimeoutSec имеет значение меньше времени ожидания надежного повтора подключения в течение 3 минут, сетевые сбои, которые длились больше, чем значение параметра OperationTimeoutSec, невозможно восстановить, так как операция на сервере истекает до повторного подключения клиента.

Тип:UInt32
Aliases:OT
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PropertyName

Находит классы, имеющие свойство, соответствующее этому имени. С этим параметром можно использовать подстановочные знаки.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-QualifierName

Фильтрует классы по имени квалификатора уровня класса. С этим параметром можно использовать подстановочные знаки.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:True

Входные данные

None

Невозможно передать объекты в этот командлет.

Выходные данные

CimClass

Этот командлет возвращает объект класса CIM.

Примечания

PowerShell включает следующие псевдонимы для Get-CimClass:

  • Windows:
    • gcls

Этот командлет доступен только на платформах Windows.