Set-WmiInstance
Egy meglévő Windows Management Instrumentation (WMI) osztály egy példányát hozza létre vagy frissíti.
Syntax
Set-WmiInstance
[-Class] <String>
[-Arguments <Hashtable>]
[-PutType <PutType>]
[-AsJob]
[-Impersonation <ImpersonationLevel>]
[-Authentication <AuthenticationLevel>]
[-Locale <String>]
[-EnableAllPrivileges]
[-Authority <String>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-ComputerName <String[]>]
[-Namespace <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-WmiInstance
-InputObject <ManagementObject>
[-Arguments <Hashtable>]
[-PutType <PutType>]
[-AsJob]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-WmiInstance
-Path <String>
[-Arguments <Hashtable>]
[-PutType <PutType>]
[-AsJob]
[-Impersonation <ImpersonationLevel>]
[-Authentication <AuthenticationLevel>]
[-Locale <String>]
[-EnableAllPrivileges]
[-Authority <String>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-ComputerName <String[]>]
[-Namespace <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-WmiInstance
[-PutType <PutType>]
[-AsJob]
[-Impersonation <ImpersonationLevel>]
[-Authentication <AuthenticationLevel>]
[-Locale <String>]
[-EnableAllPrivileges]
[-Authority <String>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-ComputerName <String[]>]
[-Namespace <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-WmiInstance
[-PutType <PutType>]
[-AsJob]
[-Impersonation <ImpersonationLevel>]
[-Authentication <AuthenticationLevel>]
[-Locale <String>]
[-EnableAllPrivileges]
[-Authority <String>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-ComputerName <String[]>]
[-Namespace <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-WmiInstance
[-PutType <PutType>]
[-AsJob]
[-Impersonation <ImpersonationLevel>]
[-Authentication <AuthenticationLevel>]
[-Locale <String>]
[-EnableAllPrivileges]
[-Authority <String>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-ComputerName <String[]>]
[-Namespace <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
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 a 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. Használat Set-WmiInstance
helyett fontolja meg a Set-CimInstance vagy a New-CimInstance parancsmagok használatát.
Példák
1. példa: WMI-naplózási szint beállítása
Set-WmiInstance -Class Win32_WMISetting -Argument @{LoggingLevel=2}
__GENUS : 2
__CLASS : Win32_WMISetting
__SUPERCLASS : CIM_Setting
__DYNASTY : CIM_Setting
__RELPATH : Win32_WMISetting=@
__PROPERTY_COUNT : 27
__DERIVATION : {CIM_Setting}
__SERVER : SYSTEM01
__NAMESPACE : root\cimv2
__PATH : \\SYSTEM01\root\cimv2:Win32_WMISetting=@
ASPScriptDefaultNamespace : \\root\cimv2
ASPScriptEnabled : False
AutorecoverMofs : {%windir%\system32\wbem\cimwin32.mof, %windir%\system32\wbem\ncprov.mof, %windir%\syst
em32\wbem\wmipcima.mof, %windir%\system32\wbem\secrcw32.mof...}
AutoStartWin9X :
BackupInterval :
BackupLastTime :
BuildVersion : 6001.18000
Caption :
DatabaseDirectory : C:\Windows\system32\wbem\repository
DatabaseMaxSize :
Description :
EnableAnonWin9xConnections :
EnableEvents : False
EnableStartupHeapPreallocation : False
HighThresholdOnClientObjects :
HighThresholdOnEvents : 20000000
InstallationDirectory : C:\Windows\system32\wbem
LastStartupHeapPreallocation :
LoggingDirectory : C:\Windows\system32\wbem\Logs\
LoggingLevel : 2
LowThresholdOnClientObjects :
LowThresholdOnEvents : 10000000
MaxLogFileSize : 65536
MaxWaitOnClientObjects :
MaxWaitOnEvents : 2000
MofSelfInstallDirectory :
SettingID :
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 olyan kivonattáblát vesz fel, amelyet az @{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
Set-WmiInstance -Class win32_environment -Argument @{Name="testvar";VariableValue="testvalue";UserName="<SYSTEM>"}
__GENUS : 2
__CLASS : Win32_Environment
__SUPERCLASS : CIM_SystemResource
__DYNASTY : CIM_ManagedSystemElement
__RELPATH : Win32_Environment.Name="testvar",UserName="<SYSTEM>"
__PROPERTY_COUNT : 8
__DERIVATION : {CIM_SystemResource, CIM_LogicalElement, CIM_ManagedSystemElement}
__SERVER : SYSTEM01
__NAMESPACE : root\cimv2
__PATH : \\SYSTEM01\root\cimv2:Win32_Environment.Name="testvar",UserName="<SYSTEM>"
Caption : <SYSTEM>\testvar
Description : <SYSTEM>\testvar
InstallDate :
Name : testvar
Status : OK
SystemVariable : True
UserName : <SYSTEM>
VariableValue : testvalue
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
Set-WmiInstance -Class Win32_WMISetting -Argument @{LoggingLevel=2} -Computername "system01", "system02", "system03"
__GENUS : 2
__CLASS : Win32_WMISetting
__SUPERCLASS : CIM_Setting
__DYNASTY : CIM_Setting
__RELPATH : Win32_WMISetting=@
__PROPERTY_COUNT : 27
__DERIVATION : {CIM_Setting}
__SERVER : SYSTEM01
__NAMESPACE : root\cimv2
__PATH : \\SYSTEM01\root\cimv2:Win32_WMISetting=@
ASPScriptDefaultNamespace : \\root\cimv2
ASPScriptEnabled : False
AutorecoverMofs : {%windir%\system32\wbem\cimwin32.mof, %windir%\system32\wbem\ncprov.mof, %windir%\syst
em32\wbem\wmipcima.mof, %windir%\system32\wbem\secrcw32.mof...}
AutoStartWin9X :
BackupInterval :
BackupLastTime :
BuildVersion : 6001.18000
Caption :
DatabaseDirectory : C:\Windows\system32\wbem\repository
DatabaseMaxSize :
Description :
EnableAnonWin9xConnections :
EnableEvents : False
EnableStartupHeapPreallocation : False
HighThresholdOnClientObjects :
HighThresholdOnEvents : 20000000
InstallationDirectory : C:\Windows\system32\wbem
LastStartupHeapPreallocation :
LoggingDirectory : C:\Windows\system32\wbem\Logs\
LoggingLevel : 2
LowThresholdOnClientObjects :
LowThresholdOnEvents : 10000000
MaxLogFileSize : 65536
MaxWaitOnClientObjects :
MaxWaitOnEvents : 2000
MofSelfInstallDirectory :
SettingID :
...
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 olyan kivonattáblát vesz fel, amelyet az @{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élda:
@{Setting1=1; Setting2=5; Setting3="test"}
Type: | Hashtable |
Aliases: | Args, Property |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Az AsJob paraméter megadásakor 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őnevét (a Feladat parancsmagjait) 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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ívja. 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
: PacketIntegrity. 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.
Type: | AuthenticationLevel |
Accepted values: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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:<DomainName értékre, ahol <a DomainName>> egy érvényes NTLM-tartománynevet azonosít. A Kerberos használatához adja meg a kerberos:<DomainName>\<ServerName> nevet. A helyi számítógéphez való csatlakozáskor nem vehet fel szolgáltatói beállítást.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Class
Egy WMI-osztály nevét adja meg.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Annak a számítógépnek a nevét adja meg, amelyen a parancsmag fut. Alapértelmezés szerint 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. Akkor is használhatja a ComputerName paramétert, ha a számítógép nincs távoli parancsok futtatására konfigurálva.
Type: | String[] |
Aliases: | Cn |
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 |
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Alapértelmezés szerint 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.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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ítani. Lehetővé teszi az objektumok számára a hívó hitelesítő adatainak lekérdezését.3
:Megszemélyesíteni. Lehetővé teszi, hogy az objektumok a hívó hitelesítő adatait használják.4
:Küldött. 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.
Type: | ImpersonationLevel |
Accepted values: | Default, Anonymous, Identify, Impersonate, Delegate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
A bemenetként használni kívánt ManagementObject objektumot adja meg. Ha ezt a paramétert használja, a rendszer az összes többi paramétert (az Argumentumok paraméter kivételével) figyelmen kívül hagyja.
Type: | ManagementObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Locale
A WMI-objektumok előnyben részesített területi beállítását adja meg. A Területi beállítás paraméter egy MS_LCID> formátumú tömbben< van megadva az előnyben részesített sorrendben.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Namespace
Megadja azt a WMI-adattár-névteret, ahol a hivatkozott WMI-osztály található, amikor az osztályparaméterrel együtt használják.
Type: | String |
Aliases: | NS |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
A létrehozni vagy frissíteni kívánt példány WMI-objektumútvonalát adja meg.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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:
UpdateOnly
meglévő WMI-példány Frissítések.CreateOnly
Létrehoz egy új WMI-példányt.UpdateOrCreate
Frissítések a WMI-példányt, ha létezik, vagy új példányt hoz létre, ha egy példány nem létezik.
Type: | PutType |
Accepted values: | None, UpdateOnly, CreateOnly, UpdateOrCreate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottleLimit
Megadja a parancs futtatásához létrehozható egyidejű kapcsolatok maximális számát. Ezt a paramétert az AsJob paraméterrel együtt használja a rendszer. A szabályozás korlátja csak az aktuális parancsra vonatkozik, a munkamenetre és a számítógépre nem.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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
None
Ez a parancsmag nem fogadja el a bemenetet.
Kimenetek
None
Ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
A Windows PowerShell a következő aliasokat Set-WmiInstance
tartalmazza:
swmi
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
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ó:Visszajelzés küldése és megtekintése a következőhöz: