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>]

Deze cmdlet is alleen beschikbaar op het Windows-platform.

Met deze cmdlet wordt een CIM-exemplaar op een CIM-server gewijzigd.

Als de parameter InputObject niet is opgegeven, werkt de cmdlet op een van de volgende manieren:

• Als noch de ComputerName parameter noch de CimSession parameter is opgegeven, werkt deze cmdlet op lokale Windows Management Instrumentation (WMI) met behulp van een COM-sessie (Component Object Model).
• Als ofwel de parameter ComputerName of de parameter CimSession is opgegeven, werkt deze cmdlet tegen de CIM-server die is gespecificeerd door ofwel de parameter ComputerName of de parameter CimSession.

Als de parameter InputObject is opgegeven, werkt de cmdlet op een van de volgende manieren:

• Als noch de parameter ComputerName noch de CimSession parameter is opgegeven, gebruikt deze cmdlet de CIM-sessie of computernaam van het invoerobject.
• Als de parameter ComputerName of de parameter CimSession is opgegeven, gebruikt deze cmdlet de waarde van de parameter CimSession of van de parameter ComputerName. Dit is niet erg gebruikelijk.

In dit voorbeeld wordt de waarde van de eigenschap VariableValue ingesteld op abcd- met behulp van de parameter Query. U kunt exemplaren wijzigen die overeenkomen met een WQL-query (Windows Management Instrumentation Query Language).

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

In dit voorbeeld wordt het CIM-exemplaarobject opgehaald dat is gefilterd op de parameter Query met behulp van de cmdlet Get-CimInstance. Cmdlet Set-CimInstance wijzigt de waarde van de VariableValue-eigenschap naar abcd.

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

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

In dit voorbeeld worden de CIM-exemplaarobjecten opgehaald die door de queryparameter zijn gefilterd op een variabele $x met behulp van Get-CimInstanceen wordt de inhoud van de variabele vervolgens doorgegeven aan de Set-CimInstance cmdlet. Set-CimInstance wijzigt vervolgens de VariableValue eigenschap naar somevalue. Omdat de parameter PassThru wordt gebruikt, retourneert dit voorbeeld een gewijzigd CIM-exemplaarobject.

In dit voorbeeld wordt het CIM-exemplaarobject, dat is opgegeven in de parameter Query, in een variabele $x geplaatst met de cmdlet Get-CimInstance, en wordt de waarde van de eigenschap VariableValue van het object gewijzigd. Het CIM-exemplaarobject wordt vervolgens opgeslagen met behulp van de cmdlet Set-CimInstance. Omdat de parameter PassThru wordt gebruikt, retourneert dit voorbeeld een gewijzigd CIM-exemplaarobject.

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

In dit voorbeeld wordt de algemene parameter WhatIf- gebruikt om op te geven dat de wijziging niet moet worden uitgevoerd, maar alleen wordt uitgevoerd wat er zou gebeuren als dit zou gebeuren.

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

In dit voorbeeld wordt de algemene parameter Bevestigen gebruikt om op te geven dat de wijziging pas moet worden uitgevoerd na bevestiging van de gebruiker.

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

In dit voorbeeld wordt een CIM-exemplaar gemaakt met de opgegeven eigenschappen met behulp van de cmdlet New-CimInstance en wordt de inhoud ervan opgehaald naar een variabele $x. De variabele wordt vervolgens doorgegeven aan de cmdlet Set-CimInstance, waarmee de waarde van de eigenschap VariableValue wordt gewijzigd in somevalue. Omdat de parameter PassThru wordt gebruikt, retourneert dit voorbeeld een gewijzigd CIM-exemplaarobject.

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

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Deze cmdlet retourneert standaard geen uitvoer.

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet het gewijzigde CIM-exemplaarobject.

PowerShell bevat de volgende aliassen voor Set-CimInstance:

• Windows:
  • scim

Deze cmdlet is alleen beschikbaar op Windows-platforms.