A Set-WmiInstance parancsmag létrehoz vagy frissít egy meglévő Windows Management Instrumentation (WMI) osztály egy példányát.
A létrehozott vagy frissített példány a WMI-adattárba lesz beírva.
A Windows PowerShell 3.0-t bevezetett új CIM-parancsmagok ugyanazokat a feladatokat hajtják végre, mint a WMI-parancsmagok.
A CIM-parancsmagok megfelelnek WS-Management (WSMan) szabványoknak és a Common Information Model (CIM) szabványnak.
Ez lehetővé teszi, hogy a parancsmagok ugyanazokat a technikákat használják a Windows-alapú számítógépek és más operációs rendszereket futtató számítógépek kezelésére.
A Set-WmiInstancehasználata helyett fontolja meg a Set-CimInstance vagy New-CimInstance parancsmagok használatát.
Ez a parancs a WMI naplózási szintjét 2-esre állítja.
A parancs átadja a beállítani kívánt tulajdonságot, az argumentumparaméterben pedig egy értékpárnak tekintett értéket.
A paraméter egy kivonattáblát vesz fel, amelyet a @{property = value} szerkezet határoz meg.
A visszaadott osztályadatok az új értéket tükrözik.
2. példa: Környezeti változó és értékének létrehozása
Ez a parancs létrehozza a testvar környezeti változót, amely rendelkezik a testvalue értékkel.
Ezt a Win32_Environment WMI-osztály új példányának létrehozásával teszi meg.
Ehhez a művelethez megfelelő hitelesítő adatokra van szükség, és előfordulhat, hogy újra kell indítania a Windows PowerShellt az új környezeti változó megtekintéséhez.
3. példa: WMI-naplózási szint beállítása több távoli számítógéphez
Ez a parancs a WMI naplózási szintjét 2-esre állítja.
A parancs átadja a beállítani kívánt tulajdonságot, az argumentumparaméterben pedig egy értékpárnak tekintett értéket.
A paraméter egy kivonattáblát vesz fel, amelyet a @{property = value} szerkezet határoz meg.
A visszaadott osztályadatok az új értéket tükrözik.
Paraméterek
-Arguments
Megadja a módosítani kívánt tulajdonság nevét és a tulajdonság új értékét.
A névnek és az értéknek név-érték párnak kell lennie.
A név-érték pár a parancssorban kivonattáblázatként lesz átadva.
Például:
@{Setting1=1; Setting2=5; Setting3="test"}
Paramétertulajdonságok
Típus:
Hashtable
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Aliasok:
Argumentumok, Ingatlan
Paraméterkészletek
class
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
object
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
path
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-AsJob
Azt jelzi, hogy ez a parancsmag háttérfeladatként fut.
Ezzel a paraméterrel olyan parancsokat futtathat, amelyek végrehajtása hosszú időt vesz igénybe.
Amikor megadja az AsJob paramétert, a parancs egy olyan objektumot ad vissza, amely a háttérfeladatot jelöli, majd megjeleníti a parancssort.
Folytathatja a munkát a munkamenetben, amíg a feladat befejeződik.
Ha Set-WmiInstance távoli számítógépen használja, a feladat a helyi számítógépen jön létre, és a távoli számítógépek eredményei automatikusan visszakerülnek a helyi számítógépre.
A feladat kezeléséhez használja a Feladat főnevet (a Feladat parancsmagokat) tartalmazó parancsmagokat.
A feladat eredményeinek lekéréséhez használja a Receive-Job parancsmagot.
Ha ezt a paramétert távoli számítógépekkel együtt szeretné használni, a helyi és a távoli számítógépeket újra kell konfigurálni az újraegyezéshez.
Emellett a Windows PowerShellt a Windows Vista és a Windows operációs rendszer későbbi verzióiban a Futtatás rendszergazdaként lehetőséggel kell elindítania.
További információ: about_Remote_Requirements.
További információ a Windows PowerShell háttérfeladatairól: about_Jobs és about_Remote_Jobs.
Paramétertulajdonságok
Típus:
SwitchParameter
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Paraméterkészletek
(All)
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-Authentication
Megadja a WMI-kapcsolathoz használni kívánt hitelesítési szintet.
A paraméter elfogadható értékei a következők:
-1: Változatlan.
0: Alapértelmezett.
1: Nincs.
Nincs hitelesítés végrehajtva.
2: Csatlakozás.
A hitelesítés csak akkor történik meg, ha az ügyfél kapcsolatot létesít az alkalmazással.
3: Hívás.
A hitelesítés csak az egyes hívások elején történik, amikor az alkalmazás megkapja a kérést.
4: Csomag.
A hitelesítés az ügyféltől kapott összes adaton történik.
5: Csomagintegritás.
Az ügyfél és az alkalmazás között továbbított összes adat hitelesítése és ellenőrzése megtörténik.
6: PacketPrivacy.
A rendszer a többi hitelesítési szint tulajdonságait használja, és az összes adat titkosítva van.
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
path
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
WQLQuery
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
query
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
list
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-Authority
Megadja a WMI-kapcsolat hitelesítéséhez használni kívánt szolgáltatót.
Megadhat standard NTLM- vagy Kerberos-hitelesítést.
Az NTLM használatához állítsa a szolgáltatói beállítást az ntlmdomain értékre:<DomainName>, ahol <DomainName> azonosítja az érvényes NTLM-tartománynevet.
A Kerberos használatához adja meg a kerberos:<DomainName>\<ServerName>.
A helyi számítógéphez való csatlakozáskor nem vehet fel szolgáltatói beállítást.
Paramétertulajdonságok
Típus:
String
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Paraméterkészletek
class
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
path
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
WQLQuery
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
query
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
list
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-Class
Egy WMI-osztály nevét adja meg.
Paramétertulajdonságok
Típus:
String
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Paraméterkészletek
class
Position:
0
Kötelező:
True
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-ComputerName
Annak a számítógépnek a nevét adja meg, amelyen a parancsmag fut.
Az alapértelmezett beállítás a helyi számítógép.
Írja be egy vagy több számítógép NetBIOS-nevét, IP-címét vagy teljes tartománynevét.
A helyi számítógép megadásához írja be a számítógép nevét, a pont (.) vagy a localhost nevet.
Ez a paraméter nem támaszkodik a Windows PowerShell-újraegyezésre.
A ComputerName paramétert akkor is használhatja, ha a számítógép nincs távoli parancsok futtatására konfigurálva.
Paramétertulajdonságok
Típus:
String[]
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Aliasok:
Cn
Paraméterkészletek
class
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
path
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
WQLQuery
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
query
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
list
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
Típus:
SwitchParameter
Alapértelmezett érték:
False
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Aliasok:
Cf
Paraméterkészletek
(All)
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg.
Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet (például User01 vagy Domain01\User01), vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot.
Ha felhasználónevet ír be, ez a parancsmag jelszót kér.
Ezt a paramétert a paraméterrel telepített szolgáltatók nem támogatják a Windows PowerShell-lel telepített szolgáltatók.
Paramétertulajdonságok
Típus:
PSCredential
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Paraméterkészletek
class
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
path
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
WQLQuery
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
query
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
list
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-EnableAllPrivileges
Azt jelzi, hogy ez a parancsmag engedélyezi az aktuális felhasználó összes engedélyét, mielőtt a parancs végrehajtja a WMI-hívást.
Paramétertulajdonságok
Típus:
SwitchParameter
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Paraméterkészletek
class
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
path
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
WQLQuery
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
query
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
list
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-Impersonation
Megadja a használni kívánt megszemélyesítési szintet.
A paraméter elfogadható értékei a következők:
0: Alapértelmezett.
Beolvassa a helyi beállításjegyzéket az alapértelmezett megszemélyesítési szinthez, amely általában 3: Megszemélyesítés.
1: Névtelen.
Elrejti a hívó hitelesítő adatait.
2: Azonosítás.
Lehetővé teszi az objektumok számára a hívó hitelesítő adatainak lekérdezését.
3: Megszemélyesítés.
Lehetővé teszi, hogy az objektumok a hívó hitelesítő adatait használják.
4: Meghatalmazott.
Lehetővé teszi, hogy az objektumok más objektumok számára is lehetővé tegyék a hívó hitelesítő adatainak használatát.
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
path
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
WQLQuery
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
query
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
list
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-InputObject
A bemenetként használandó ManagementObject objektumot adja meg.
Ha ezt a paramétert használja, a rendszer az összes többi paramétert (kivéve a argumentumokat paramétert) figyelmen kívül hagyja.
Paramétertulajdonságok
Típus:
ManagementObject
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Paraméterkészletek
object
Position:
Named
Kötelező:
True
Folyamatból származó érték:
True
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-Locale
A WMI-objektumok előnyben részesített területi beállítását adja meg.
A Területi paraméter az MS_<LCID> formátum egyik tömbjében van megadva az előnyben részesített sorrendben.
Paramétertulajdonságok
Típus:
String
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Paraméterkészletek
class
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
path
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
WQLQuery
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
query
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
list
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-Namespace
Megadja a WMI-adattár névterét, ahol a hivatkozott WMI-osztály a osztály paraméterrel való használatakor található.
Paramétertulajdonságok
Típus:
String
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Aliasok:
NS
Paraméterkészletek
class
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
path
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
WQLQuery
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
query
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
list
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-Path
A létrehozni vagy frissíteni kívánt példány WMI-objektumútvonalát adja meg.
Paramétertulajdonságok
Típus:
String
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Paraméterkészletek
path
Position:
Named
Kötelező:
True
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-PutType
Azt jelzi, hogy létre kívánja-e hozni vagy frissíteni a WMI-példányt.
A paraméter elfogadható értékei a következők:
Csak frissítés.
Meglévő WMI-példány frissítése.
Csak létrehozása.
Létrehoz egy új WMI-példányt.
UpdateOrCreate.
Frissíti a WMI-példányt, ha létezik, vagy új példányt hoz létre, ha egy példány nem létezik.
Paramétertulajdonságok
Típus:
PutType
Alapértelmezett érték:
None
Elfogadott értékek:
None, UpdateOnly, CreateOnly, UpdateOrCreate
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Paraméterkészletek
(All)
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-ThrottleLimit
Megadja a parancs futtatásához létrehozható egyidejű kapcsolatok maximális számát.
Ezt a paramétert együtt használja a AsJob paraméterrel.
A szabályozás korlátja csak az aktuális parancsra vonatkozik, a munkamenetre és a számítógépre nem.
Paramétertulajdonságok
Típus:
Int32
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Paraméterkészletek
(All)
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna.
A parancsmag nem fut.
Paramétertulajdonságok
Típus:
SwitchParameter
Alapértelmezett érték:
False
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Aliasok:
Wi
Paraméterkészletek
(All)
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.