Set-CimInstance

Set-CimInstance
    [-InputObject] <CimInstance>
    [-ComputerName <String[]>]
    [-ResourceUri <Uri>]
    [-OperationTimeoutSec <UInt32>]
    [-Property <IDictionary>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-CimInstance
    [-InputObject] <CimInstance>
    -CimSession <CimSession[]>
    [-ResourceUri <Uri>]
    [-OperationTimeoutSec <UInt32>]
    [-Property <IDictionary>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-CimInstance
    [-Query] <String>
    -CimSession <CimSession[]>
    -Property <IDictionary>
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-CimInstance
    [-Query] <String>
    -Property <IDictionary>
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

El cmdlet Set-CimInstance modifica una instancia CIM en un servidor CIM.

Si no se especifica el parámetro InputObject, el cmdlet funciona de una de las maneras siguientes:

• Si no se especifica el parámetro ComputerName ni el parámetro CimSession, este cmdlet funciona en la sesión local de Instrumental de administración de Windows (WMI) mediante una sesión del modelo de objetos componentes (COM).
• Si se especifica el parámetro ComputerName o el parámetro CimSession, este cmdlet funciona con el servidor CIM especificado por el parámetro ComputerName o el parámetro CimSession.

Si se especifica el parámetro InputObject, el cmdlet funciona de una de las maneras siguientes:

• Si no se especifica el parámetro ComputerName ni el parámetro CimSession, este cmdlet usa la sesión CIM o el nombre de equipo del objeto de entrada.
• Si se especifica el parámetro ComputerName o el parámetro CimSession, este cmdlet usa el valor del parámetro CimSession o el valor del parámetro ComputerName. Nota: Esto no es muy común.

Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"}

Este comando establece el valor de la propiedad VariableValue en abcd mediante el parámetro Query. Puede modificar instancias que coincidan con una consulta del lenguaje de consulta de Instrumental de administración de Windows (WQL).

Get-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' | Set-CimInstance -Property @{VariableValue="abcd"}

Este comando recupera el objeto de instancia CIM filtrado por el parámetro Query mediante el cmdlet Get-CimInstance y, a continuación, pasa los objetos al cmdlet Set-CimInstance, que modifica el valor de la propiedad VariableValue a abcd.

$x = Get-CimInstance -Query 'Select * from Win32_Environment where Name="testvar"'
Set-CimInstance -InputObject $x -Property @{VariableValue="somevalue"} -PassThru

Este conjunto de comandos recupera los objetos de instancia CIM filtrados por el parámetro Query en una variable ($x) mediante Get-CimInstance y, a continuación, pasa el contenido de la variable al cmdlet Set-CimInstance. Set-CimInstance luego modifica la propiedad VariableValue a somevalue. Dado que se usa el parámetro Passthru, este conjunto de comandos devuelve un objeto de instancia CIM modificado.

$x = Get-CimInstance -Query 'Select * from Win32_Environment where name="testvar"'
$x.VariableValue = "Change"
Set-CimInstance -CimInstance $x -PassThru

Este conjunto de comandos recupera el objeto de instancia CIM especificado en el parámetro Query en una variable ($x) mediante el cmdlet Get-CimInstance y cambia el valor de la propiedad VariableValue del objeto que se va a cambiar. A continuación, el objeto de instancia CIM se guarda mediante el cmdlet Set-CimInstance. Dado que se usa el parámetro Passthru, este conjunto de comandos devuelve un objeto de instancia CIM modificado.

Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -WhatIf

Este comando usa el parámetro común WhatIf para especificar que no se debe realizar la modificación, sino solo generar lo que sucedería si se hiciera.

Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -Confirm

Este comando usa el parámetro común Confirm para especificar que la modificación debe realizarse solo después de la confirmación del usuario.

$x = New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";UserName="domain\user"} -Keys Name,UserName -ClientOnly
Set-CimInstance -CimInstance $x -Property @{VariableValue="somevalue"} -PassThru

Este conjunto de comandos crea una instancia CIM con las propiedades especificadas mediante el cmdlet New-CimInstance y recupera su contenido en en una variable ($x). A continuación, la variable se pasa al cmdlet Set-CimInstance, que modifica el valor de la propiedad VariableValue a algún valor. Dado que se usa el parámetro Passthru, este conjunto de comandos devuelve un objeto de instancia CIM modificado.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Cuando se especifica el parámetro Passthru, este cmdlet devuelve un objeto de instancia CIM modificado.