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} konstrukció 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 testvalueértékkel rendelkezik. 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} konstrukció 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:
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 távoli számítógéphez használják, 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 el kell indítania a Windows PowerShellt a Futtatás rendszergazdaként beállítással. További információkért lásd: about_Remote_Requirements.
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 ntlmdomain:<DomainName>értékre, ahol <DomainName> azonosít egy é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 adhatja meg a szolgáltatói beállítást.
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-újraküldé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.
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.
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.
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 egy MS_<LCID> formátumú tömbben van megadva az előnyben részesített sorrendben.
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.
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.
Bevitelek
None
Ez a parancsmag nem fogadja el a bemenetet.
Kimenetek
None
Ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
A Windows PowerShell a Set-WmiInstancekövetkező aliasait tartalmazza:
A tartalom forrása a GitHubon található, ahol létrehozhat és áttekinthet problémákat és lekéréses kérelmeket is. További információért tekintse meg a közreműködői útmutatónkat.