Get-CimClass
Возвращает список классов CIM в определенном пространстве имен.
Синтаксис
ComputerSet (по умолчанию)
Get-CimClass
[[-ClassName] <string>]
[[-Namespace] <string>]
[-Amended]
[-OperationTimeoutSec <uint>]
[-ComputerName <string[]>]
[-MethodName <string>]
[-PropertyName <string>]
[-QualifierName <string>]
[<CommonParameters>]
SessionSet
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. Получение всех определений классов
В этом примере возвращаются все определения классов в пространстве имен root/CIMV2.
Get-CimClass
Пример 2. Получение классов с определенным именем
В этом примере получаются классы, содержащие слово disk в именах.
Get-CimClass -ClassName *Disk*
Пример 3. Получение классов с определенным именем метода
В этом примере получаются классы, начинающиеся с имени Win32 и имеющие имя метода, начинающееся с Термин.
Get-CimClass -ClassName Win32* -MethodName Term*
Пример 4. Получение классов с определенным именем свойства
В этом примере возвращаются классы, начинающиеся с имени Win32 и имеющие свойство Handle.
Get-CimClass -ClassName Win32* -PropertyName Handle
Пример 5. Получение классов с определенным именем квалификатора
Этот пример получает классы, начинающиеся с имени Win32, содержат слово disk в именах и имеют указанный квалификатор Ассоциации.
Get-CimClass -ClassName Win32*Disk* -QualifierName Association
Пример 6. Получение определений классов из определенного пространства имен
В этом примере возвращаются определения классов, содержащие слово Net в именах из указанного пространства имен root/StandardCimv2.
Get-CimClass -Namespace root/StandardCimv2 -ClassName *Net*
Пример 7. Получение определений классов с удаленного сервера
В этом примере возвращаются определения классов, содержащие слово disk из указанных удаленных серверов 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CimSession
Выполняет командлет в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные командлета New-CimSession или Get-CimSession. По умолчанию используется текущий сеанс на локальном компьютере.
Свойства параметра
| Тип: | |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
SessionSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ClassName
Указывает имя класса CIM, для которого выполняется операция. Вы можете использовать завершение вкладки для просмотра списка классов, так как PowerShell получает список классов с локального сервера WMI для предоставления списка имен классов.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ComputerName
Указывает компьютер, на котором требуется выполнить операцию CIM. Можно указать полное доменное имя (FQDN) имя NetBIOS или IP-адрес.
При указании этого параметра командлет создает временный сеанс для указанного компьютера с помощью протокола WsMan.
Если этот параметр не указан, командлет выполняет операцию на локальном компьютере с помощью объектной модели компонента (COM).
Если несколько операций выполняются на одном компьютере, использование сеанса CIM обеспечивает лучшую производительность.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Китай, Имя сервера |
Наборы параметров
ComputerSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-MethodName
Находит классы, имеющие метод, соответствующий этому имени. С этим параметром можно использовать подстановочные знаки.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Namespace
Указывает пространство имен для операции CIM. Пространство имен по умолчанию — корневой/CIMV2. Вы можете использовать завершение вкладки для просмотра списка пространств имен, так как PowerShell получает список пространств имен с локального сервера WMI для предоставления списка пространств имен.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-OperationTimeoutSec
Указывает период времени, в течение которого командлет ожидает ответа от компьютера. По умолчанию значение этого параметра равно 0, что означает, что командлет использует значение времени ожидания по умолчанию для сервера.
Если параметр OperationTimeoutSec имеет значение меньше времени ожидания надежного повтора подключения в 3 минуты, сетевые сбои, длящиеся дольше, чем значение параметра OperationTimeoutSec, не подлежат восстановлению, так как время операции на сервере истекает до того, как клиент успевает переподключиться.
Свойства параметра
| Тип: | UInt32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | OT |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-PropertyName
Находит классы, имеющие свойство, соответствующее этому имени. С этим параметром можно использовать подстановочные знаки.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-QualifierName
Фильтрует классы по имени квалификатора уровня класса. С этим параметром можно использовать подстановочные знаки.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
None
Невозможно передать объекты в этот командлет.
Выходные данные
CimClass
Этот командлет возвращает объект класса CIM.
Примечания
PowerShell включает следующие псевдонимы для Get-CimClass:
- Виндоус:
gcls
Этот командлет доступен только на платформах Windows.
