Get-CimInstance

Синтаксис

ClassNameComputerSet (по умолчанию)

Get-CimInstance
    [-ClassName] <String>
    [-ComputerName <String[]>]
    [-KeyOnly]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-Shallow]
    [-Filter <String>]
    [-Property <String[]>]
    [<CommonParameters>]

ResourceUriSessionSet

Get-CimInstance
    -CimSession <CimSession[]>
    -ResourceUri <Uri>
    [-KeyOnly]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-Shallow]
    [-Filter <String>]
    [-Property <String[]>]
    [<CommonParameters>]

QuerySessionSet

Get-CimInstance
    -CimSession <CimSession[]>
    -Query <String>
    [-ResourceUri <Uri>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-Shallow]
    [<CommonParameters>]

ClassNameSessionSet

Get-CimInstance
    [-ClassName] <String>
    -CimSession <CimSession[]>
    [-KeyOnly]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-Shallow]
    [-Filter <String>]
    [-Property <String[]>]
    [<CommonParameters>]

CimInstanceSessionSet

Get-CimInstance
    [-InputObject] <CimInstance>
    -CimSession <CimSession[]>
    [-ResourceUri <Uri>]
    [-OperationTimeoutSec <UInt32>]
    [<CommonParameters>]

CimInstanceComputerSet

Get-CimInstance
    [-InputObject] <CimInstance>
    [-ResourceUri <Uri>]
    [-ComputerName <String[]>]
    [-OperationTimeoutSec <UInt32>]
    [<CommonParameters>]

ResourceUriComputerSet

Get-CimInstance
    -ResourceUri <Uri>
    [-ComputerName <String[]>]
    [-KeyOnly]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-Shallow]
    [-Filter <String>]
    [-Property <String[]>]
    [<CommonParameters>]

QueryComputerSet

Get-CimInstance
    -Query <String>
    [-ResourceUri <Uri>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-Shallow]
    [<CommonParameters>]

Описание

Примеры

Пример 1. Получение экземпляров указанного класса CIM

Get-CimInstance -ClassName Win32_Process

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

Get-CimInstance -Namespace root -ClassName __Namespace

Пример 3. Получение экземпляров класса, отфильтрованного с помощью запроса

Get-CimInstance -Query "SELECT * from Win32_Process WHERE name LIKE 'P%'"

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

Get-CimInstance -ClassName Win32_Process -Filter "Name like 'P%'"

Пример 5. Получение экземпляров CIM с заполненными только ключевыми свойствами

$instance = @{
    ClassName = 'Win32_Process'
    Namespace = 'root/cimv2'
    Properties = @{
        Handle = 0
    }
    Key = 'Handle'
    ClientOnly = $true
}
$x = New-CimInstance @instance
Get-CimInstance -CimInstance $x

Пример 6. Получение экземпляров CIM и их повторное использование

$x, $y = Get-CimInstance -ClassName Win32_Process
$x | Format-Table -Property Name, KernelModeTime -AutoSize

Name                 KernelModeTime
----                 --------------
System Idle Process 157238797968750

Пример 7. Получение экземпляров CIM с удаленного компьютера

Get-CimInstance -ClassName Win32_ComputerSystem -ComputerName Server01, Server02

Пример 8. Получение только ключевых свойств вместо всех свойств

$x = Get-CimInstance -Class Win32_Process -KeyOnly
$x | Invoke-CimMethod -MethodName GetOwner

Пример 9. Получение только подмножества свойств вместо всех свойств

Get-CimInstance -Class Win32_Process -Property Name, KernelModeTime
$x = Get-CimInstance -Class Win32_Process -Property Name, KernelModeTime
$x | Invoke-CimMethod -MethodName GetOwner

Пример 10. Получение экземпляра объекта CIM с помощью сеанса CIM

$s = New-CimSession -ComputerName Server01, Server02
Get-CimInstance -ClassName Win32_ComputerSystem -CimSession $s

Параметры

-CimSession

Указывает сеанс CIM, используемый для этого командлета. Введите переменную, содержащую сеанс CIM или команду, которая создает или получает сеанс CIM, например командлеты New-CimSession или Get-CimSession. Дополнительные сведения см. в разделе about_CimSession.

Свойства параметра

Наборы параметров

-ClassName

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

Свойства параметра

Наборы параметров

-ComputerName

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

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

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

Свойства параметра

Наборы параметров

-Filter

Указывает условие where для фильтрации. Укажите утверждение в языке запросов WQL или CQL. Не включайте ключевое слово WHERE в значение параметра.

Свойства параметра

Наборы параметров

-InputObject

Указывает объект экземпляра CIM для использования в качестве входных данных.

Если вы уже работаете с объектом экземпляра CIM, этот параметр можно использовать для передачи объекта экземпляра CIM для получения последнего моментального снимка с сервера CIM. При передаче объекта экземпляра CIM в качестве входных данных Get-CimInstance возвращает объект с сервера с помощью операции получения CIM вместо операции перечисления или запроса. Использование операции "get CIM" более эффективно, чем извлечение всех экземпляров и их последующая фильтрация.

Параметр InputObject не перечисляет коллекции. В случае передачи коллекции возникает ошибка. При работе с коллекциями направьте входные данные для перечисления значений.

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

Свойства параметра

Наборы параметров

-KeyOnly

Указывает, что возвращаются только объекты с заполненными ключевыми свойствами. Указание параметра KeyOnly уменьшает объем данных, передаваемых по сети.

Используйте параметр KeyOnly, чтобы вернуть только небольшую часть объекта, которую можно использовать для других операций, таких как командлеты Set-CimInstance или Get-CimAssociatedInstance.

Свойства параметра

Наборы параметров

-Namespace

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

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

Свойства параметра

Наборы параметров

-OperationTimeoutSec

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

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

Свойства параметра

Наборы параметров

-Property

Задает набор свойств экземпляра для извлечения. Используйте этот параметр, если необходимо уменьшить размер возвращаемого объекта в памяти или по сети. Возвращенный объект также содержит ключевые свойства, даже если вы не перечислили их с помощью параметра Property. Другие свойства класса присутствуют, но они не заполнены.

Свойства параметра

Наборы параметров

-Query

Указывает запрос, выполняемый на сервере CIM. Если указанное значение содержит двойные кавычки ", одинарные кавычки 'или обратную косую черту \, необходимо экранировать эти символы, префиксируя их символом обратной косой черты. Если указанное значение использует оператор WQL LIKE, необходимо экранировать следующие символы, заключив их в квадратные скобки []: процент %, подчеркивание _или открытие квадратной скобки [.

Невозможно использовать запрос метаданных для получения списка классов или запроса события. Чтобы получить список классов, используйте командлет Get-CimClass. Чтобы получить запрос события, используйте командлет Register-CimIndicationEvent.

Можно указать диалект запроса с помощью параметра QueryDialect.

Свойства параметра

Наборы параметров

-QueryDialect

Указывает язык запросов, используемый для параметра query. Допустимые значения для этого параметра: WQL или CQL. Значение по умолчанию — WQL.

Свойства параметра

Наборы параметров

-ResourceUri

Указывает универсальный идентификатор ресурса (URI) класса ресурса или экземпляра. Универсальный код ресурса (URI) используется для определения определенного типа ресурса, например дисков или процессов на компьютере.

URI состоит из префикса и пути к ресурсу. Рассмотрим пример.

• http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
• http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

По умолчанию, если этот параметр не указан, используется стандартный универсальный код ресурса DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/, а имя класса добавляется к нему.

ResourceUri можно использовать только с сеансами CIM, созданными с помощью протокола WSMan, или при указании параметра ComputerName, который создает сеанс CIM с помощью WSMan. Если этот параметр указан без указания параметра ComputerName или при указании сеанса CIM, созданного с помощью протокола DCOM, возникает ошибка, так как протокол DCOM не поддерживает параметр ResourceUri.

Если заданы и параметр ResourceUri, и параметр фильтра, параметр фильтра игнорируется.

Свойства параметра

Наборы параметров

-Shallow

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

Свойства параметра

Наборы параметров

CommonParameters

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

CimInstance

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

CimInstance

Примечания

Связанные ссылки

• Format-Table
• Get-CimAssociatedInstance
• Get-CimClass
• Invoke-CimMethod
• New-CimInstance
• Register-CimIndicationEvent
• Remove-CimInstance
• Set-CimInstance