Set-WmiInstance

Referenz

Modul:: Microsoft.PowerShell.Management

Erstellt oder aktualisiert eine Instanz einer vorhandenen Windows-Verwaltungsinstrumentation (WMI)-Klasse.

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

Beschreibung

Das cmdlet Set-WmiInstance erstellt oder aktualisiert eine Instanz einer vorhandenen Windows-Verwaltungsinstrumentation (WMI)-Klasse. Die erstellte oder aktualisierte Instanz wird in das WMI-Repository geschrieben.

Neue CIM-Cmdlets, die Windows PowerShell 3.0 eingeführt haben, führen dieselben Aufgaben wie die WMI-Cmdlets aus. Die CIM-Cmdlets entsprechen WS-Management (WSMan)-Standards und dem Common Information Model (CIM)-Standard. Auf diese Weise können Cmdlets dieselben Techniken verwenden, um Windows-basierte Computer und andere Betriebssysteme zu verwalten. Anstatt Set-WmiInstancezu verwenden, sollten Sie die Set-CimInstance oder New-CimInstance-Cmdlets verwenden.

Beispiele

Beispiel 1: Festlegen der WMI-Protokollierungsebene

Set-WmiInstance -Class Win32_WMISetting -Arguments @{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\n...}
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                      :

Mit diesem Befehl wird die WMI-Protokollierungsebene auf 2 festgelegt. Der Befehl übergibt die festzulegende Eigenschaft und den Wert, zusammen als Wertpaar betrachtet, im Argumentparameter. Der Parameter verwendet eine Hashtabelle, die durch die @{property = value}-Konstruktion definiert wird. Die zurückgegebenen Klasseninformationen spiegeln den neuen Wert wider.

Beispiel 2: Erstellen einer Umgebungsvariable und des zugehörigen Werts

$setWmiInstanceSplat = @{
    Class = 'win32_environment'
    Arguments = @{
        Name="testvar"
        VariableValue="testvalue"
        UserName="<SYSTEM>"
    }
}
Set-WmiInstance @setWmiInstanceSplat

__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

Mit diesem Befehl wird die testvar Umgebungsvariable erstellt, die den Wert testvaluehat. Dazu wird eine neue Instanz der Win32_Environment WMI-Klasse erstellt. Für diesen Vorgang sind geeignete Anmeldeinformationen erforderlich, und Möglicherweise müssen Sie Windows PowerShell neu starten, um die neue Umgebungsvariable anzuzeigen.

Beispiel 3: Festlegen der WMI-Protokollierungsebene für mehrere Remotecomputer

$setWmiInstanceSplat = @{
    Class = 'Win32_WMISetting'
    Arguments = @{LoggingLevel = 2}
    ComputerName = 'system01', 'system02', 'system03'
}
Set-WmiInstance @setWmiInstanceSplat

__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\n...}
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                      :
...

Parameter

-Arguments

Gibt den Namen der zu ändernden Eigenschaft und den neuen Wert für diese Eigenschaft an. Der Name und der Wert müssen ein Name-Wert-Paar sein. Das Name-Wert-Paar wird in der Befehlszeile als Hashtabelle übergeben. Zum Beispiel:

@{Setting1=1; Setting2=5; Setting3="test"}

Typ:	Hashtable
Aliase:	Args, Property
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AsJob

Gibt an, dass dieses Cmdlet als Hintergrundauftrag ausgeführt wird. Verwenden Sie diesen Parameter, um Befehle auszuführen, die lange dauern.

Wenn Sie den AsJob--Parameter angeben, gibt der Befehl ein Objekt zurück, das den Hintergrundauftrag darstellt, und zeigt dann die Eingabeaufforderung an. Sie können weiterhin in der Sitzung arbeiten, während der Auftrag abgeschlossen ist. Wenn sie für einen Remotecomputer verwendet wird, wird der Auftrag auf dem lokalen Computer erstellt, und die Ergebnisse von Remotecomputern werden automatisch an den lokalen Computer zurückgegeben. Verwenden Sie zum Verwalten des Auftrags die Cmdlets, die das Auftrag Substantiv enthalten (die cmdlets Job). Verwenden Sie das Cmdlet Receive-Job, um die Auftragsergebnisse abzurufen.

Um diesen Parameter zusammen mit Remotecomputern zu verwenden, müssen die lokalen und Remotecomputer für remoting konfiguriert werden. Darüber hinaus müssen Sie Windows PowerShell mit der Option Als Administrator ausführen starten. Weitere Informationen finden Sie unter about_Remote_Requirements.

Weitere Informationen zu Windows PowerShell-Hintergrundaufträgen finden Sie unter about_Jobs und about_Remote_Jobs.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Authentication

Gibt die Authentifizierungsebene an, die mit der WMI-Verbindung verwendet werden muss. Die zulässigen Werte für diesen Parameter sind:

-1: Unverändert.
0: Standard.
1: Keine. Es wurde keine Authentifizierung ausgeführt.
2: Verbinden. Die Authentifizierung wird nur ausgeführt, wenn der Client eine Beziehung mit der Anwendung herstellt.
3: Anruf. Die Authentifizierung erfolgt nur zu Beginn jedes Anrufs, wenn die Anwendung die Anforderung empfängt.
4: Paket. Die Authentifizierung erfolgt für alle Daten, die vom Client empfangen werden.
5: PacketIntegrity. Alle Daten, die zwischen dem Client und der Anwendung übertragen werden, werden authentifiziert und überprüft.
6: PacketPrivacy. Die Eigenschaften der anderen Authentifizierungsstufen werden verwendet, und alle Daten werden verschlüsselt.

Typ:	AuthenticationLevel
Zulässige Werte:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Authority

Gibt die Autorität an, die zum Authentifizieren der WMI-Verbindung verwendet werden soll. Sie können die standardmäßige NTLM- oder Kerberos-Authentifizierung angeben. Um NTLM zu verwenden, legen Sie die Autoritätseinstellung auf ntlmdomain:<DomainName>fest, wobei <DomainName> einen gültigen NTLM-Domänennamen identifiziert. Geben Sie kerberos:<DomainName>\<ServerName>an, um Kerberos zu verwenden. Sie können die Autoritätseinstellung nicht einschließen, wenn Sie eine Verbindung mit dem lokalen Computer herstellen.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Class

Gibt den Namen einer WMI-Klasse an.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ComputerName

Gibt den Namen des Computers an, auf dem dieses Cmdlet ausgeführt wird. Der Standardwert ist der lokale Computer.

Geben Sie den NetBIOS-Namen, eine IP-Adresse oder einen vollqualifizierten Domänennamen eines oder mehrerer Computer ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen, einen Punkt (.) oder localhost ein.

Dieser Parameter basiert nicht auf Windows PowerShell-Remoting. Sie können den parameter ComputerName verwenden, auch wenn Ihr Computer nicht für die Ausführung von Remotebefehlen konfiguriert ist.

Typ:	String[]
Aliase:	Cn
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Credential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Die Standardeinstellung ist der aktuelle Benutzer.

Geben Sie einen Benutzernamen ein, z. B. User01 oder Domain01\User01, oder geben Sie ein PSCredential--Objekt ein, z. B. einen, der vom Cmdlet Get-Credential generiert wird. Wenn Sie einen Benutzernamen eingeben, fordert dieses Cmdlet ein Kennwort ein.

Dieser Parameter wird von anbietern, die mit parametern installiert sind, nicht unterstützt, von anbietern, die mit Windows PowerShell installiert sind.

Typ:	PSCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EnableAllPrivileges

Gibt an, dass dieses Cmdlet alle Berechtigungen des aktuellen Benutzers aktiviert, bevor der Befehl ausgeführt wird, der den WMI-Aufruf vorgibt.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Impersonation

Gibt die zu verwendende Identitätswechselebene an. Die zulässigen Werte für diesen Parameter sind:

0: Standard. Liest die lokale Registrierung für die Standardidentitätswechselebene, die in der Regel auf 3 festgelegt ist: Identitätswechsel.
1: Anonym. Blendet die Anmeldeinformationen des Aufrufers aus.
2: Identifizieren. Ermöglicht Es Objekten, die Anmeldeinformationen des Aufrufers abzufragen.
3: Identitätswechsel. Ermöglicht es Objekten, die Anmeldeinformationen des Aufrufers zu verwenden.
4: Stellvertretung. Ermöglicht Objekten die Verwendung der Anmeldeinformationen des Aufrufers für andere Objekte.

Typ:	ImpersonationLevel
Zulässige Werte:	Default, Anonymous, Identify, Impersonate, Delegate
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Gibt ein ManagementObject--Objekt an, das als Eingabe verwendet werden soll. Wenn dieser Parameter verwendet wird, werden alle anderen Parameter außer den Argumenten Parameter ignoriert.

Typ:	ManagementObject
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Locale

Gibt das bevorzugte Gebietsschema für WMI-Objekte an. Der parameter locale wird in einem Array im MS_<LCID> Format in der bevorzugten Reihenfolge angegeben.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Namespace

Gibt den WMI-Repositorynamespace an, in dem sich die referenzierte WMI-Klasse befindet, wenn sie mit dem parameter Class verwendet wird.

Typ:	String
Aliase:	NS
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Path

Gibt einen WMI-Objektpfad der Instanz an, die Sie erstellen oder aktualisieren möchten.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PutType

Gibt an, ob die WMI-Instanz erstellt oder aktualisiert werden soll. Die zulässigen Werte für diesen Parameter sind:

UpdateOnly Aktualisiert eine vorhandene WMI-Instanz.
CreateOnly Erstellt eine neue WMI-Instanz.
UpdateOrCreate Aktualisiert die WMI-Instanz, wenn sie vorhanden ist, oder erstellt eine neue Instanz, wenn keine Instanz vorhanden ist.

Typ:	PutType
Zulässige Werte:	None, UpdateOnly, CreateOnly, UpdateOrCreate
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ThrottleLimit

Gibt die maximale Anzahl gleichzeitiger Verbindungen an, die zum Ausführen dieses Befehls eingerichtet werden können. Dieser Parameter wird zusammen mit dem parameter AsJob verwendet. Der Drosselungsgrenzwert gilt nur für den aktuellen Befehl, nicht für die Sitzung oder den Computer.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

None

Dieses Cmdlet akzeptiert keine Eingabe.

Ausgaben

None

Dieses Cmdlet generiert keine Ausgabe.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Set-WmiInstance:

swmi

Freigeben über

Set-WmiInstance

Syntax

Beschreibung

Beispiele

Beispiel 1: Festlegen der WMI-Protokollierungsebene

Beispiel 2: Erstellen einer Umgebungsvariable und des zugehörigen Werts

Beispiel 3: Festlegen der WMI-Protokollierungsebene für mehrere Remotecomputer

Parameter

-Arguments

-AsJob

-Authentication

-Authority

-Class

-ComputerName

-Confirm

-Credential

-EnableAllPrivileges

-Impersonation

-InputObject

-Locale

-Namespace

-Path

-PutType

-ThrottleLimit

-WhatIf

Eingaben

Ausgaben

Hinweise

Zusätzliche Ressourcen

Freigeben über

Set-WmiInstance

Syntax

Beschreibung

Beispiele

Beispiel 1: Festlegen der WMI-Protokollierungsebene

Beispiel 2: Erstellen einer Umgebungsvariable und des zugehörigen Werts

Beispiel 3: Festlegen der WMI-Protokollierungsebene für mehrere Remotecomputer

Parameter

-Arguments

-AsJob

-Authentication

-Authority

-Class

-ComputerName

-Confirm

-Credential

-EnableAllPrivileges

-Impersonation

-InputObject

-Locale

-Namespace

-Path

-PutType

-ThrottleLimit

-WhatIf

Eingaben

Ausgaben

Hinweise

Ähnliche Themen

Zusätzliche Ressourcen