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. Получение всех определений классов
В этом примере возвращаются все определения классов в пространстве имен root/cimv2.
Get-CimClass
Пример 2. Получение классов с определенным именем
В этом примере возвращаются классы, содержащие слово disk в именах.
Get-CimClass -ClassName *disk*
Пример 3. Получение классов с определенным именем метода
В этом примере возвращаются классы, которые начинаются с имени Win32 и имеют имя метода, начинающееся с Term.
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CimSession
Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные командлета New-CimSession
или Get-CimSession
. Сеанс по умолчанию — текущий сеанс на локальном компьютере.
Type: | CimSession[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ClassName
Указывает имя класса CIM, для которого выполняется операция. Вы можете использовать завершение табуляции для просмотра списка классов, так как PowerShell получает список классов с локального сервера WMI для предоставления списка имен классов.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-ComputerName
Указывает компьютер, на котором требуется выполнить операцию CIM. Вы можете указать полное доменное имя (FQDN), NetBIOS-имя или IP-адрес.
Если указать этот параметр, командлет создает временный сеанс для указанного компьютера по протоколу WsMan.
Если этот параметр не указан, командлет выполняет операцию на локальном компьютере с помощью компонентной объектной модели (COM).
Если на одном компьютере выполняется несколько операций, использование сеанса CIM обеспечивает более высокую производительность.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MethodName
Находит классы, имеющие метод, соответствующий этому имени. С этим параметром можно использовать подстановочные знаки.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Namespace
Задает пространство имен для операции CIM. Пространство имен по умолчанию — root/cimv2. Вы можете использовать завершение табуляции для просмотра списка пространств имен, так как PowerShell получает список пространств имен с локального сервера WMI для предоставления списка пространств имен.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OperationTimeoutSec
Указывает время, в течение которого командлет ожидает ответа от компьютера. По умолчанию значение этого параметра равно 0, что означает, что командлет использует значение времени ожидания по умолчанию для сервера.
Если для параметра OperationTimeoutSec задано значение меньше, чем время ожидания повторной попытки надежного подключения в 3 минуты, то сбои сети, которые длятся больше, чем значение параметра OperationTimeoutSec , невозможно восстановить, так как время ожидания операции на сервере истекает, прежде чем клиент сможет повторно подключиться.
Type: | UInt32 |
Aliases: | OT |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PropertyName
Находит классы, имеющие свойство, соответствующее этому имени. С этим параметром можно использовать подстановочные знаки.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-QualifierName
Фильтрует классы по имени квалификатора уровня класса. С этим параметром можно использовать подстановочные знаки.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
Входные данные
None
Вы не можете передавать объекты в этот командлет.
Выходные данные
Этот командлет возвращает объект класса CIM.
Примечания
PowerShell включает следующие псевдонимы для Get-CimClass
:
- Windows:
gcls
Этот командлет доступен только на платформах Windows.