Командлет New-CimInstance создает экземпляр класса CIM на основе определения класса на локальном компьютере или удаленном компьютере. По умолчанию командлет New-CimInstance создает экземпляр на локальном компьютере.
Примеры
Пример 1. Создание экземпляра класса CIM
В этом примере создается экземпляр класса CIM с именем Win32_Environment в пространстве имен root/CIMV2 на компьютере.
Проверка на стороне клиента не выполняется, если класс не существует, свойства неправы или если сервер отклоняет вызов. Если экземпляр создан успешно, командлет выводит только что созданный экземпляр.
Пример 2. Создание экземпляра класса CIM с помощью схемы класса
В этом примере извлекается объект класса CIM и сохраняется в переменной с именем $class. Затем содержимое переменной передается командлету New-CimInstance.
Пример 3. Создание динамического экземпляра на клиенте
В этом примере создается динамический экземпляр класса CIM с именем Win32_Process на клиентском компьютере без получения экземпляра с сервера. Новый экземпляр хранится в переменной $a. Этот динамический экземпляр можно использовать для выполнения операций, если экземпляр с этим ключом существует на сервере.
ProcessId Name HandleCount WorkingSetSize VirtualSize
--------- ---- ----------- -------------- -----------
0 System Idle Process 0 8192 8192
Domain :
ReturnValue : 2
User :
PSComputerName :
Затем командлет Get-CimInstance извлекает конкретный отдельный экземпляр. Командлет Invoke-CimMethod вызывает метод GetOwner в извлеченном экземпляре.
Пример 4. Создание экземпляра класса CIM в определенном пространстве имен
В этом примере извлекается экземпляр класса CIM с именем MSFT_Something в пространстве имен root/somewhere и сохраняется в переменной с именем $class. Переменная передается командлету New-CimInstance для создания нового экземпляра CIM и выполнения клиентских проверок нового экземпляра.
В этом примере с помощью параметра CimClass вместо параметра ClassName проверяется, что Prop1 и Prop2 фактически существуют и что ключи помечены правильно.
Параметры ComputerName или CimSession нельзя использовать с параметром ClientOnly.
Параметры
-CimClass
Указывает объект класса CIM, представляющий тип экземпляра. Используйте командлет Get-CimClass для получения объявления класса с компьютера. Использование этого параметра приводит к улучшению проверки схемы на стороне клиента.
Выполняет команду с помощью указанного сеанса CIM. Введите переменную, содержащую сеанс CIM, или команду, которая создает или получает сеанс CIM, например командлеты New-CimSession или Get-CimSession. Дополнительные сведения см. в разделе about_CimSession.
Указывает имя класса CIM, из которого операция создает экземпляр. ПРИМЕЧАНИЕ. Вы можете использовать завершение вкладки для просмотра списка классов, так как PowerShell получает список классов с локального сервера WMI для предоставления списка имен классов.
Указывает, что экземпляр создается только в PowerShell, не перейдя на сервер CIM. Этот параметр можно использовать для создания экземпляра CIM в памяти для использования в последующих операциях PowerShell.
Задает пространство имен класса для нового экземпляра. Пространство имен по умолчанию — корневой/CIMV2.
Вы можете использовать завершение вкладки для просмотра списка пространств имен, так как PowerShell получает список пространств имен с локального сервера WMI для предоставления списка пространств имен.
Указывает время, в течение которого командлет ожидает ответа от сервера CIM. По умолчанию значение этого параметра равно 0, что означает, что командлет использует значение времени ожидания по умолчанию для сервера. Если параметр OperationTimeoutSec имеет значение меньше времени ожидания надежного повтора подключения в 3 минуты, сетевые сбои, длящиеся дольше, чем значение параметра OperationTimeoutSec, не подлежат восстановлению, так как время операции на сервере истекает до того, как клиент успевает переподключиться.
Указывает свойства экземпляра CIM с помощью хэш-таблицы (пар "имя-значение").
Если указать параметр CimClass , командлет выполняет проверку свойств на клиенте, чтобы убедиться, что указанные свойства соответствуют объявлению класса на сервере. Если параметр CimClass не указан, проверка свойств выполняется на сервере.
Указывает универсальный идентификатор ресурса (URI) класса ресурса или экземпляра. Универсальный код ресурса (URI) используется для определения определенного типа ресурса, например дисков или процессов на компьютере.
URI состоит из префикса и пути к ресурсу. Рассмотрим пример.
По умолчанию, если этот параметр не указан, используется стандартный универсальный код ресурса DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/, а имя класса добавляется к нему.
ResourceUri можно использовать только с сеансами CIM, созданными с помощью протокола WSMan, или при указании параметра ComputerName, который создает сеанс CIM с помощью WSMan. Если этот параметр указан без указания параметра ComputerName или при указании сеанса CIM, созданного с помощью протокола DCOM, возникает ошибка, так как протокол DCOM не поддерживает параметр ResourceUri.
Если заданы и параметр ResourceUri, и параметр фильтра, параметр фильтра игнорируется.
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
