Set-CimInstance
Изменяет экземпляр CIM на сервере CIM путем вызова метода ModifyInstance класса CIM.
Синтаксис
Set-CimInstance
[-ComputerName <String[]>]
[-ResourceUri <Uri>]
[-OperationTimeoutSec <UInt32>]
[-InputObject] <CimInstance>
[-Property <IDictionary>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CimInstance
-CimSession <CimSession[]>
[-ResourceUri <Uri>]
[-OperationTimeoutSec <UInt32>]
[-InputObject] <CimInstance>
[-Property <IDictionary>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CimInstance
-CimSession <CimSession[]>
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
[-Query] <String>
[-QueryDialect <String>]
-Property <IDictionary>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CimInstance
[-ComputerName <String[]>]
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
[-Query] <String>
[-QueryDialect <String>]
-Property <IDictionary>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Этот командлет изменяет экземпляр CIM на сервере CIM.
Если параметр InputObject не указан, командлет работает одним из следующих способов:
- Если ни параметр ComputerName, ни параметр CimSession не указан, этот командлет работает в локальном сеансе инструментария управления Windows (WMI) с помощью сеанса com-модели компонентов.
- Если указан параметр ComputerName или параметр CimSession, этот командлет работает с сервером CIM, указанным параметром ComputerName или параметром CimSession.
Если указан параметр InputObject, командлет работает одним из следующих способов:
- Если ни параметр ComputerName, ни параметр CimSession не указан, этот командлет использует сеанс CIM или имя компьютера из входного объекта.
- Если указан параметр ComputerName или параметр CimSession, этот командлет использует значение параметра CimSession или значение параметра ComputerName. Это не очень распространено.
Примеры
Пример 1. Установка экземпляра CIM
В этом примере значение свойства VariableValue присваивается abcd с помощью параметра Query. Можно изменить экземпляры, соответствующие запросу языка запросов инструментария управления Windows (WQL).
Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"}
Пример 2. Установка свойства экземпляра CIM с помощью конвейера
В этом примере извлекается объект экземпляра CIM, отфильтрованный параметром запроса с помощью командлета Get-CimInstance
. Командлет Set-CimInstance
изменяет значение свойства VariableValue на abcd.
Get-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' |
Set-CimInstance -Property @{VariableValue="abcd"}
Пример 3. Установка свойства экземпляра CIM с помощью входного объекта
$x = Get-CimInstance -Query 'Select * from Win32_Environment where Name="testvar"'
Set-CimInstance -InputObject $x -Property @{VariableValue="somevalue"} -PassThru
В этом примере извлекаются объекты экземпляра CIM, отфильтрованные параметром запроса в переменную с помощьюGet-CimInstance
, а затем передает содержимое переменной $x
командлетуSet-CimInstance
. Set-CimInstance
затем изменяет свойство VariableValue на некоторое значение. Так как используется параметр Passthru, в этом примере возвращается измененный объект экземпляра CIM.
Пример 4. Установка свойства экземпляра CIM
В этом примере извлекается объект экземпляра CIM, указанный в параметре query , в переменную $x
с помощью Get-CimInstance
командлета, и изменяет значение свойства VariableValue объекта на изменение. Затем объект экземпляра CIM сохраняется с помощью командлета Set-CimInstance
.
Так как используется параметр Passthru, в этом примере возвращается измененный объект экземпляра CIM.
$x = Get-CimInstance -Query 'Select * from Win32_Environment where name="testvar"'
$x.VariableValue = "Change"
Set-CimInstance -CimInstance $x -PassThru
Пример 5. Отображение списка экземпляров CIM для изменения с помощью WhatIf
В этом примере используется общий параметр WhatIf , чтобы указать, что изменение не должно выполняться, но выводить только то, что произойдет, если это было сделано.
Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -WhatIf
Пример 6. Установка экземпляра CIM после подтверждения от пользователя
В этом примере используется общий параметр Confirm , чтобы указать, что изменение должно выполняться только после подтверждения от пользователя.
Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -Confirm
Пример 7. Установка созданного экземпляра CIM
В этом примере создается экземпляр CIM с указанными свойствами с помощью командлета New-CimInstance
и извлекается его содержимое в переменную $x
. Затем переменная передается командлету Set-CimInstance
, который изменяет значение свойства VariableValue на некоторое значение.
Так как используется параметр Passthru, в этом примере возвращается измененный объект экземпляра CIM.
$x = New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";UserName="domain\user"} -Key Name,UserName -ClientOnly
Set-CimInstance -CimInstance $x -Property @{VariableValue="somevalue"} -PassThru
Параметры
-CimSession
Выполняет командлеты на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные командлета или Get-CimSession
командлетаNew-CimSession
.
Тип: | CimSession[] |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ComputerName
Указывает имя компьютера, на котором требуется выполнить операцию CIM. Можно указать полное доменное имя (FQDN) или имя NetBIOS.
Если этот параметр не указан, командлет выполняет операцию на локальном компьютере с помощью объектной модели компонента (COM).
При указании этого параметра командлет создает временный сеанс для указанного компьютера с помощью протокола WsMan.
Если на одном компьютере выполняются несколько операций, подключение с помощью сеанса CIM обеспечивает более высокую производительность.
Тип: | String[] |
Aliases: | CN, ServerName |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputObject
Указывает объект экземпляра CIM для использования в качестве входных данных.
Параметр InputObject не перечисляет коллекции. Если коллекция передается, возникает ошибка. При работе с коллекциями передайте входные данные для перечисления значений.
Тип: | CimInstance |
Aliases: | CimInstance |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Namespace
Указывает пространство имен для операции CIM. Пространство имен по умолчанию — root/cimv2. Вы можете использовать завершение вкладки для просмотра списка пространств имен, так как PowerShell получает список пространств имен с локального сервера WMI для предоставления списка пространств имен.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-OperationTimeoutSec
Указывает время ожидания командлетом ответа от компьютера. По умолчанию значение этого параметра равно 0, что означает, что командлет использует значение времени ожидания по умолчанию для сервера.
Если параметр OperationTimeoutSec имеет значение меньше времени ожидания надежного повтора подключения в течение 3 минут, сетевые сбои, которые длились больше, чем значение параметра OperationTimeoutSec, невозможно восстановить, так как операция на сервере истекает до повторного подключения клиента.
Тип: | UInt32 |
Aliases: | OT |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-PassThru
Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не создает выходные данные.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Property
Указывает свойства экземпляра CIM в виде хэш-таблицы (с помощью пар "имя-значение"). Изменяются только свойства, указанные с помощью этого параметра. Другие свойства экземпляра CIM не изменяются.
Тип: | IDictionary |
Aliases: | Arguments |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Query
Указывает запрос для запуска на сервере CIM для получения экземпляров CIM, на которых выполняется командлет. Можно указать диалект запроса с помощью параметра QueryDialect.
Если указанное значение содержит двойные кавычки (), одинарные кавычки ("
'
) или обратную косую черту (\
), необходимо экранировать эти символы, префиксируя их с помощью символа обратной косой черты (\
). Если указанное значение использует оператор WQL LIKE, необходимо экранировать следующие символы, заключив их в квадратные скобки (): процент%
(), подчеркивание ([]
_
) или открывающую квадратную скобку ([
).
Тип: | String |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-QueryDialect
Указывает язык запросов, используемый для параметра query. Допустимые значения для этого параметра: WQL или CQL. Значение по умолчанию — WQL.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-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
По умолчанию, если этот параметр не указан, используется стандартный URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/
ресурса DMTF и к нему добавляется имя класса.
ResourceURI можно использовать только с сеансами CIM, созданными с помощью протокола WSMan, или при указании параметра ComputerName, который создает сеанс CIM с помощью WSMan. Если этот параметр указан без указания параметра ComputerName или при указании сеанса CIM, созданного с помощью протокола DCOM, возникает ошибка, так как протокол DCOM не поддерживает параметр ResourceURI.
Если указан параметр ResourceUri и параметр Filter, параметр Filter игнорируется.
Тип: | Uri |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Выходные данные
None
По умолчанию этот командлет не возвращает выходные данные.
При использовании параметра Passthru этот командлет возвращает измененный объект экземпляра CIM.
Связанные ссылки
PowerShell