Set-CimInstance

Referens

Modul:: CimCmdlets

Ändrar en CIM-instans på en CIM-server genom att anropa metoden ModifyInstance för CIM-klassen.

Syntax

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

Description

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 CimSession-parametern anges fungerar den här cmdleten på den lokala WMI-sessionen (Windows Management Instrumentation) med hjälp av en COM-session (Component Object Model).
Om parametern ComputerName eller parametern CimSession anges fungerar den här cmdleten mot CIM-servern 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 CimSession-parametern har angetts 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 parametervärdet ComputerName . Detta är inte särskilt vanligt.

Exempel

Exempel 1: Ange CIM-instansen

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

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

Exempel 2: Ange egenskapen CIM-instans med pipeline

Det här exemplet hämtar CIM-instansobjektet som filtrerats av 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"}

Exempel 3: Ange egenskapen CIM-instans med hjälp av indataobjekt

$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-instansobjekten som filtrerats av 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.

Exempel 4: Ange egenskapen CIM-instans

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

Exempel 5: Visa listan över CIM-instanser som ska ändras med WhatIf

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

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

Exempel 6: Ange CIM-instansen efter bekräftelse från användaren

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

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

Exempel 7: Ange den skapade CIM-instansen

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.

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

Parametrar

-CimSession

Kör cmdletarna på en fjärrdator. Ange ett datornamn eller ett sessionsobjekt, till exempel utdata från en eller Get-CimSession en New-CimSession cmdlet.

Type:	CimSession[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

Anger namnet på den dator där du vill köra CIM-åtgärden. Du kan ange ett fullständigt kvalificerat domännamn (FQDN) eller ett NetBIOS-namn.

Om du inte anger den här parametern utför cmdleten åtgärden på den lokala datorn med hjälp av Component Object Model (COM).

Om du anger den här parametern skapar cmdleten en tillfällig session på den angivna datorn med hjälp av WsMan-protokollet.

Om flera åtgärder utförs på samma dator ger anslutning med en CIM-session bättre prestanda.

Type:	String[]
Aliases:	CN, ServerName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Anger ett CIM-instansobjekt som ska användas som indata.

Parametern InputObject räknas inte upp över samlingar. Om en samling skickas utlöses ett fel. När du arbetar med samlingar kan du skicka indata för att räkna upp värdena.

Type:	CimInstance
Aliases:	CimInstance
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Namespace

Anger namnområdet för CIM-åtgärden. Standardnamnområdet är root/cimv2. Du kan använda tabbavslut för att bläddra i listan över namnområden eftersom PowerShell hämtar en lista över namnområden från den lokala WMI-servern för att ange listan över namnområden.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-OperationTimeoutSec

Anger hur lång tid cmdleten väntar på ett svar från datorn. Som standard är värdet för den här parametern 0, vilket innebär att cmdleten använder standardvärdet för timeout för servern.

Om parametern OperationTimeoutSec är inställd på ett värde som är mindre än den robusta tidsgränsen för återförsök av anslutningen på 3 minuter kan nätverksfel som varar mer än värdet för parametern OperationTimeoutSec inte återställas, eftersom åtgärden på servern överskrider tidsgränsen innan klienten kan återansluta.

Type:	UInt32
Aliases:	OT
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet inga utdata.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Property

Anger egenskaperna för CIM-instansen som en hash-tabell (med namn/värde-par). Endast de egenskaper som anges med den här parametern ändras. Andra egenskaper för CIM-instansen ändras inte.

Type:	IDictionary
Aliases:	Arguments
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Query

Anger en fråga som ska köras på CIM-servern för att hämta CIM-instanser som cmdleten ska köras på. Du kan ange frågedialekten med parametern QueryDialect.

Om det angivna värdet innehåller dubbla citattecken ("), enkla citattecken (') eller ett omvänt snedstreck (\) måste du undvika dessa tecken genom att prefixera dem med omvänt snedstreck (\). Om det angivna värdet använder WQL LIKE-operatorn måste du undvika följande tecken genom att omsluta dem inom hakparenteser (): procent ([]%), understreck (_) eller inledande hakparentes ().[

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-QueryDialect

Anger det frågespråk som används för frågeparametern. Godkända värden för den här parametern är: WQL eller CQL. Standardvärdet är WQL.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceUri

Anger resursens enhetliga resursidentifierare (URI) för resursklassen eller instansen. URI:n används för att identifiera en specifik typ av resurs, till exempel diskar eller processer, på en dator.

En URI består av ett prefix och en sökväg till en resurs. Exempel:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

Om du inte anger den här parametern används standardresurs-URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ :n för DMTF som standard och klassnamnet läggs till i den.

ResourceURI kan bara användas med CIM-sessioner som skapats med hjälp av WSMan-protokollet, eller när du anger parametern ComputerName, som skapar en CIM-session med WSMan. Om du anger den här parametern utan att ange parametern ComputerName, eller om du anger en CIM-session som skapats med DCOM-protokollet, får du ett fel eftersom DCOM-protokollet inte stöder ResourceURI-parametern.

Om både ResourceUri-parametern och filterparametern anges ignoreras filterparametern.

Type:	Uri
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Indata

CimInstance

Utdata