Set-CimInstance
Módosítja a CIM-kiszolgálón lévő CIM-példányt a CIM-osztály ModifyInstance metódusának meghívásával.
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
Ez a parancsmag csak a Windows platformon érhető el.
Ez a parancsmag módosít egy CIM-példányt egy CIM-kiszolgálón.
Ha az InputObject paraméter nincs megadva, a parancsmag az alábbi módok egyikével működik:
- Ha sem a ComputerName paraméter, sem a CimSession paraméter nincs megadva, akkor ez a parancsmag a helyi Windows Management Instrumentation (WMI) rendszeren működik egy komponensobjektum-modell (COM) munkamenettel.
- Ha a ComputerName paraméter vagy a CimSession paraméter van megadva, akkor ez a parancsmag a ComputerName vagy a CimSession paraméter által megadott CIM-kiszolgálóval működik.
Ha az InputObject paraméter meg van adva, a parancsmag a következő módok egyikével működik:
- Ha sem a ComputerName paraméter, sem a CimSession paraméter nincs megadva, akkor ez a parancsmag a bemeneti objektum CIM-munkamenetét vagy számítógépnevét használja.
- Ha a ComputerName vagy a CimSession paraméter van megadva, akkor ez a parancsmag a CimSession paraméter vagy a ComputerName paraméter értékét használja. Ez nem túl gyakori.
Példák
1. példa: A CIM-példány beállítása
Ez a példa a VariableValue tulajdonság értékét abcd értékre állítja a Query paraméterrel. A Windows Management Instrumentation Query Language (WQL) lekérdezésnek megfelelő példányokat módosíthatja.
Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"}2. példa: A CIM-példány tulajdonság beállítása folyamattal
Ez a példa a lekérdezési paraméterrel szűrt CIM-példányobjektumot kéri le a Get-CimInstance parancsmag használatával. A Set-CimInstance parancsmag a VariableValue tulajdonság értékét abcd értékre módosítja.
Get-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' |
Set-CimInstance -Property @{VariableValue="abcd"}3. példa: A CIM-példány tulajdonság beállítása bemeneti objektummal
$x = Get-CimInstance -Query 'Select * from Win32_Environment where Name="testvar"'
Set-CimInstance -InputObject $x -Property @{VariableValue="somevalue"} -PassThruEz a példa beolvassa a Lekérdezés paraméter által szűrt CIM-példányobjektumokat egy változóba $xGet-CimInstance, majd átadja a változó tartalmát a Set-CimInstance parancsmagnak. Set-CimInstanceezután módosítja a VariableValue tulajdonságot valamilyen értékre. Mivel a Passthru paramétert használja, ez a példa egy módosított CIM-példányobjektumot ad vissza.
4. példa: A CIM-példány tulajdonságának beállítása
Ez a példa beolvassa a Lekérdezés paraméterben megadott CIM-példányobjektumot egy változóba $x a Get-CimInstance parancsmag használatával, és módosítja az objektum VariableValue tulajdonságértékét. A CIM-példány objektuma ezután a Set-CimInstance parancsmaggal lesz mentve.
Mivel a Passthru paramétert használja, ez a példa egy módosított CIM-példányobjektumot ad vissza.
$x = Get-CimInstance -Query 'Select * from Win32_Environment where name="testvar"'
$x.VariableValue = "Change"
Set-CimInstance -CimInstance $x -PassThru5. példa: A WhatIf használatával módosítandó CIM-példányok listájának megjelenítése
Ez a példa a WhatIf közös paraméterét használja annak meghatározására, hogy a módosítást nem szabad elvégezni, hanem csak azt, hogy mi történjen, ha megtörtént.
Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -WhatIf6. példa: A CIM-példány beállítása a felhasználó visszaigazolása után
Ez a példa a Confirm paramétert használja annak megadására, hogy a módosítást csak a felhasználó visszaigazolása után kell végrehajtani.
Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -Confirm7. példa: A létrehozott CIM-példány beállítása
Ez a példa létrehoz egy CIM-példányt a megadott tulajdonságokkal a New-CimInstance parancsmag használatával, és beolvassa annak tartalmát egy változóba $x. A változó ezután át lesz adva a Set-CimInstance parancsmagnak, amely módosítja a VariableValue tulajdonság értékét egy értékre.
Mivel a Passthru paramétert használja, ez a példa egy módosított CIM-példányobjektumot ad vissza.
$x = New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";UserName="domain\user"} -Key Name,UserName -ClientOnly
Set-CimInstance -CimInstance $x -Property @{VariableValue="somevalue"} -PassThruParaméterek
-CimSession
Távoli számítógépen futtatja a parancsmagokat. Adjon meg egy számítógépnevet vagy egy munkamenet-objektumot, például egy vagy Get-CimSession egy New-CimSession parancsmag kimenetét.
| Type: | CimSession[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
Megadja annak a számítógépnek a nevét, amelyen futtatni szeretné a CIM-műveletet. Megadhat teljes tartománynevet (FQDN) vagy NetBIOS-nevet.
Ha nem adja meg ezt a paramétert, a parancsmag a helyi számítógépen hajtja végre a műveletet a Component Object Model (COM) használatával.
Ha megadja ezt a paramétert, a parancsmag létrehoz egy ideiglenes munkamenetet a megadott számítógépen a WsMan protokoll használatával.
Ha ugyanazon a számítógépen több műveletet végeznek, a CIM-munkamenet használatával való csatlakozás jobb teljesítményt nyújt.
| Type: | String[] |
| Aliases: | CN, ServerName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Megadja a bemenetként használni kívánt CIM-példányobjektumot.
Az InputObject paraméter nem számba veszi a gyűjteményeket. Ha egy gyűjteményt ad át, hibaüzenet jelenik meg. A gyűjtemények használatakor a bemenetet a bemenetet az értékek számbavételéhez kell beszűkíteni.
| Type: | CimInstance |
| Aliases: | CimInstance |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Namespace
Megadja a CIM-művelet névterét. Az alapértelmezett névtér a root/cimv2. A tabulátorkiegészítéssel tallózhat a névterek listájában, mivel a PowerShell lekéri a névterek listáját a helyi WMI-kiszolgálóról a névterek listájának megadásához.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OperationTimeoutSec
Megadja, hogy a parancsmag mennyi időt vár a számítógép válaszára. Alapértelmezés szerint ennek a paraméternek az értéke 0, ami azt jelenti, hogy a parancsmag a kiszolgáló alapértelmezett időtúllépési értékét használja.
Ha az OperationTimeoutSec paraméter értéke kisebb, mint a robusztus kapcsolat újrapróbálkozási időtúllépése 3 perc, akkor az OperationTimeoutSec paraméter értékénél hosszabb hálózati hibák nem állíthatók helyre, mert a kiszolgálón végzett művelet túllépi az időkorlátot, mielőtt az ügyfél újracsatlakozhat.
| Type: | UInt32 |
| Aliases: | OT |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Property
A CIM-példány tulajdonságait adja meg kivonattáblaként (név-érték párok használatával). Csak az ezzel a paraméterrel megadott tulajdonságok módosulnak. A CIM-példány egyéb tulajdonságai nem változnak.
| Type: | IDictionary |
| Aliases: | Arguments |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Query
Megadja a CIM-kiszolgálón futtatandó lekérdezést a parancsmag futtatásához használandó CIM-példányok lekéréséhez. A lekérdezés dialektusát a QueryDialect paraméterrel adhatja meg.
Ha a megadott érték dupla idézőjeleket (), egyszeri idézőjeleket ("') vagy fordított perjelet (\) tartalmaz, ezeket a karaktereket a fordított perjel (\) karakter előtagjával kell feloldani. Ha a megadott érték a WQL LIKE operátort használja, akkor a következő karaktereket úgy kell feloldani, hogy szögletes zárójelekbe (): százalékba (%[]), aláhúzásjelbe (_) vagy nyitó szögletes zárójelbe ([) foglalja őket.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-QueryDialect
A Lekérdezés paraméterhez használt lekérdezési nyelvet adja meg. A paraméter elfogadható értékei a következők: WQL vagy CQL. Az alapértelmezett érték a WQL.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceUri
Az erőforrásosztály vagy -példány erőforrás-egységes erőforrás-azonosítóját (URI) adja meg. Az URI egy adott típusú erőforrás, például lemezek vagy folyamatok azonosítására szolgál a számítógépen.
Az URI egy előtagból és egy erőforrás elérési útból áll. Példa:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDiskhttp://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings
Alapértelmezés szerint, ha nem adja meg ezt a paramétert, a rendszer a DMTF standard erőforrás-URI-t http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ használja, és hozzáfűzi az osztály nevét.
A ResourceURI csak a WSMan protokollal létrehozott CIM-munkamenetekkel használható, vagy a ComputerName paraméter megadásakor, amely a WSMan használatával hoz létre CIM-munkamenetet. Ha ezt a paramétert a ComputerName paraméter megadása nélkül adja meg, vagy ha egy DCOM protokoll használatával létrehozott CIM-munkamenetet ad meg, hibaüzenet jelenik meg, mert a DCOM protokoll nem támogatja a ResourceURI paramétert.
Ha a ResourceUri paraméter és a Szűrő paraméter is meg van adva, a szűrő paraméter figyelmen kívül lesz hagyva.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Bevitelek
Kimenetek
None
Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.
A Passthru paraméter használatakor ez a parancsmag a módosított CIM-példányobjektumot adja vissza.
Jegyzetek
A PowerShell a következő aliasokat Set-CimInstancetartalmazza:
- Windows:
scim
Ez a parancsmag csak Windows-platformokon érhető el.
Kapcsolódó hivatkozások
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: