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

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Den här cmdleten ändrar en CIM-instans på en CIM-server.

Om parametern InputObject inte anges fungerar cmdleten på något av följande sätt:

• Om varken parametern ComputerName eller parametern CimSession anges, fungerar den här cmdleten på den lokala Windows Management Instrumentation (WMI) med hjälp av en COM-session (Component Object Model).
• Om parametern ComputerName eller parametern CimSession anges, fungerar den här cmdleten mot den CIM-server som anges av parametern ComputerName eller parametern CimSession.

Om parametern InputObject anges fungerar cmdleten på något av följande sätt:

• Om varken parametern ComputerName eller parametern CimSession anges använder den här cmdleten CIM-sessionen eller datornamnet från indataobjektet.
• Om parametern ComputerName eller parametern CimSession anges använder den här cmdleten antingen parametervärdet CimSession eller ComputerName parametervärde. Detta är inte särskilt vanligt.

I det här exemplet anges värdet för egenskapen VariableValue till abcd med hjälp av frågeparametern. Du kan ändra instanser som matchar en WQL-fråga (Windows Management Instrumentation Query Language).

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

Det här exemplet hämtar CIM-instansobjektet som filtrerats efter frågeparametern med hjälp av cmdleten Get-CimInstance . Cmdleten Set-CimInstance ändrar värdet för egenskapen VariableValue till 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

Det här exemplet hämtar CIM-instansobjekt som filtrerats efter frågeparametern i till en variabel $x med hjälp Get-CimInstanceav och skickar sedan innehållet i variabeln till cmdleten Set-CimInstance . Set-CimInstance ändrar sedan egenskapen VariableValue till somevalue. Eftersom parametern PassThru används returnerar det här exemplet ett ändrat CIM-instansobjekt.

Det här exemplet hämtar CIM-instansobjektet som anges i frågeparametern till en variabel $x med hjälp av cmdleten Get-CimInstance och ändrar egenskapen VariableValue för objektet som ska ändras. CIM-instansobjektet sparas sedan med hjälp av cmdleten Set-CimInstance . Eftersom parametern PassThru används returnerar det här exemplet ett ändrat CIM-instansobjekt.

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

I det här exemplet används den gemensamma parametern WhatIf för att ange att ändringen inte ska göras, utan endast utdata vad som skulle hända om den gjordes.

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

I det här exemplet används den gemensamma parametern Confirm (Bekräfta ) för att ange att ändringen endast ska göras efter bekräftelse från användaren.

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

Det här exemplet skapar en CIM-instans med de angivna egenskaperna med hjälp av cmdleten New-CimInstance och hämtar innehållet i till en variabel $x. Variabeln skickas sedan till cmdleten Set-CimInstance , som ändrar värdet för egenskapen VariableValue till somevalue. Eftersom parametern PassThru används returnerar det här exemplet ett ändrat CIM-instansobjekt.

$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

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Som standard returnerar den här cmdleten inga utdata.

När du använder parametern PassThru returnerar den här cmdleten det ändrade CIM-instansobjektet.

PowerShell innehåller följande alias för Set-CimInstance:

• Windows:
  • scim

Den här cmdleten är endast tillgänglig på Windows-plattformar.