Set-WmiInstance
Mevcut bir Windows Yönetim Araçları (WMI) sınıfının örneğini oluşturur veya güncelleştirir.
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
Set-WmiInstance Cmdlet, mevcut bir Windows Yönetim Araçları (WMI) sınıfının örneğini oluşturur veya güncelleştirir. Oluşturulan veya güncelleştirilen örnek WMI deposuna yazılır.
Windows PowerShell 3.0 ile sunulan yeni CIM cmdlet'leri WMI cmdlet'leriyle aynı görevleri gerçekleştirir. CIM cmdlet'leri WS-Management (WSMan) standartlarına ve Ortak Bilgi Modeli (CIM) standardına uygundur. bu, cmdlet'lerin Windows tabanlı bilgisayarları ve diğer işletim sistemlerini çalıştıran bilgisayarları yönetmek için aynı teknikleri kullanmasına olanak tanır. yerine Set-WmiInstanceSet-CimInstance veya New-CimInstance cmdlet'lerini kullanmayı göz önünde bulundurun.
Örnekler
Örnek 1: WMI günlük düzeyini ayarlama
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 :Bu komut WMI günlük düzeyini 2 olarak ayarlar. komutu, ayarlanacak özelliğini ve değeri bağımsız değişken parametresinde bir değer çifti olarak kabul eder. parametresi, yapısı tarafından @{property = value} tanımlanan bir karma tablosu alır. Döndürülen sınıf bilgileri yeni değeri yansıtır.
Örnek 2: Ortam değişkeni ve değeri oluşturma
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 : testvalueBu komut, testvalue değerini içeren testvar ortam değişkenini oluşturur. Bunu, Win32_Environment WMI sınıfının yeni bir örneğini oluşturarak yapar. Bu işlem uygun kimlik bilgileri gerektirir ve yeni ortam değişkenini görmek için Windows PowerShell'i yeniden başlatmanız gerekebilir.
Örnek 3: Birkaç uzak bilgisayar için WMI günlük düzeyini ayarlama
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 :
...Bu komut WMI günlük düzeyini 2 olarak ayarlar. komutu, ayarlanacak özelliğini ve değeri bağımsız değişken parametresinde bir değer çifti olarak kabul eder. parametresi, yapısı tarafından @{property = value} tanımlanan bir karma tablosu alır. Döndürülen sınıf bilgileri yeni değeri yansıtır.
Parametreler
-Arguments
Değiştirilecek özelliğin adını ve bu özelliğin yeni değerini belirtir. Ad ve değer bir ad-değer çifti olmalıdır. Ad-değer çifti, komut satırında karma tablo olarak geçirilir. Örneğin:
@{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
Bu cmdlet'in arka plan işi olarak çalıştığını gösterir. Tamamlanması uzun süren komutları çalıştırmak için bu parametreyi kullanın.
AsJob parametresini belirttiğinizde, komut arka plan işini temsil eden bir nesne döndürür ve ardından komut istemini görüntüler. İş tamamlarken oturumda çalışmaya devam edebilirsiniz. Uzak bir bilgisayar için kullanılırsa, iş yerel bilgisayarda oluşturulur ve uzak bilgisayarlardan elde edilen sonuçlar otomatik olarak yerel bilgisayara döndürülür. İşi yönetmek için İş adlarını (İş cmdlet'leri) içeren cmdlet'leri kullanın. İş sonuçlarını almak için cmdlet'ini Receive-Job kullanın.
Bu parametreyi uzak bilgisayarlarla birlikte kullanmak için yerel ve uzak bilgisayarların uzaktan iletişim için yapılandırılması gerekir. Ayrıca, Windows Vista'da yönetici olarak çalıştır seçeneğini ve Windows işletim sisteminin sonraki sürümlerini kullanarak Windows PowerShell'i başlatmanız gerekir. Daha fazla bilgi için bkz . about_Remote_Requirements.
Windows PowerShell arka plan işleri hakkında daha fazla bilgi için bkz . about_Jobs ve about_Remote_Jobs.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Authentication
WMI bağlantısıyla kullanılması gereken kimlik doğrulama düzeyini belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
-1:Değişme -den.0: Varsayılan.1:Hiçbiri. Kimlik doğrulaması yapılmaz.2: Bağlan. Kimlik doğrulaması yalnızca istemci uygulamayla bir ilişki kurduğunda gerçekleştirilir.3:Çağrı. Kimlik doğrulaması yalnızca uygulama isteği aldığında her çağrının başlangıcında gerçekleştirilir.4:Paket. Kimlik doğrulaması, istemciden alınan tüm verilerde gerçekleştirilir.5: PacketIntegrity. İstemci ile uygulama arasında aktarılan tüm verilerin kimliği doğrulanır ve doğrulanır.6: PacketPrivacy. Diğer kimlik doğrulama düzeylerinin özellikleri kullanılır ve tüm veriler şifrelenir.
| 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
WMI bağlantısının kimliğini doğrulamak için kullanılacak yetkiyi belirtir. Standart NTLM veya Kerberos kimlik doğrulaması belirtebilirsiniz. NTLM'yi kullanmak için, yetkili ayarını ntlmdomain:<DomainName olarak ayarlayın; burada <DomainName>> geçerli bir NTLM etki alanı adı tanımlar. Kerberos kullanmak için kerberos:<DomainName\<ServerName>> belirtin. Yerel bilgisayara bağlanırken yetkili ayarını ekleyemezsiniz.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Class
WMI sınıfının adını belirtir.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
Bu cmdlet'in çalıştığı bilgisayarın adını belirtir. Varsayılan, yerel bilgisayardır.
Bir veya daha fazla bilgisayarın NetBIOS adını, IP adresini veya tam etki alanı adını yazın.
Yerel bilgisayarı belirtmek için bilgisayar adını, nokta (). veya localhost yazın.
Bu parametre Windows PowerShell uzaktan iletişimini kullanmaz. Bilgisayarınız uzak komutları çalıştıracak şekilde yapılandırılmamış olsa bile ComputerName parametresini kullanabilirsiniz.
| Type: | String[] |
| Aliases: | Cn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır.
User01 veya Domain01\User01 gibi bir kullanıcı adı yazın veya Get-Credential cmdlet'i tarafından oluşturulan gibi bir PSCredential nesnesi girin. Bir kullanıcı adı yazarsanız, bu cmdlet parola ister.
Bu parametre, parametresiyle yüklenen hiçbir sağlayıcı tarafından desteklenmez, Windows PowerShell ile yüklenen sağlayıcılar tarafından desteklenmez.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableAllPrivileges
Bu cmdlet'in WMI çağrısından önce geçerli kullanıcının tüm izinlerini etkinleştirdiğini gösterir.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Impersonation
Kullanılacak kimliğe bürünme düzeyini belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
0: Varsayılan. Varsayılan kimliğe bürünme düzeyi için yerel kayıt defterini okur ve bu değer genellikle 3: Kimliğe bürün olarak ayarlanır.1:Anonim. Çağıranın kimlik bilgilerini gizler.2:Tanımlamak. Nesnelerin çağıranın kimlik bilgilerini sorgulamasına izin verir.3:Taklit. Nesnelerin çağıranın kimlik bilgilerini kullanmasına izin verir.4:Temsilci. Nesnelerin diğer nesnelerin çağıranın kimlik bilgilerini kullanmasına izin vermesine izin verir.
| 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
Giriş olarak kullanılacak bir ManagementObject nesnesi belirtir. Bu parametre kullanıldığında, Arguments parametresi dışındaki diğer tüm parametreler yoksayılır.
| Type: | ManagementObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Locale
WMI nesneleri için tercih edilen yerel ayarı belirtir. Locale parametresi, MS_<LCID> biçimindeki bir dizide tercih edilen sırada belirtilir.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Namespace
Sınıf parametresiyle kullanıldığında başvuruda bulunulan WMI sınıfının bulunduğu WMI deposu ad alanını belirtir.
| Type: | String |
| Aliases: | NS |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Oluşturmak veya güncelleştirmek istediğiniz örneğin WMI nesne yolunu belirtir.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PutType
WMI örneğinin oluşturulup oluşturulmayacağını veya güncelleştirilip güncelleştirilmeyeceğini gösterir. Bu parametrenin kabul edilebilir değerleri şunlardır:
UpdateOnlyMevcut bir WMI örneğini Güncelleştirmeler.CreateOnlyYeni bir WMI örneği oluşturur.UpdateOrCreateVarsa WMI örneğini Güncelleştirmeler veya bir örnek yoksa yeni bir örnek oluşturur.
| Type: | PutType |
| Accepted values: | None, UpdateOnly, CreateOnly, UpdateOrCreate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ThrottleLimit
Bu komutu çalıştırmak için oluşturulabilecek en fazla eşzamanlı bağlantı sayısını belirtir. Bu parametre AsJob parametresiyle birlikte kullanılır. Kısıtlama sınırı yalnızca geçerli komut için geçerlidir, oturuma veya bilgisayara uygulanmaz.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Girişler
None
Bu cmdlet girişi kabul etmiyor.
Çıkışlar
None
Bu cmdlet çıkış oluşturmaz.
Notlar
Windows PowerShell için aşağıdaki diğer adları Set-WmiInstanceiçerir:
swmi
İlişkili Bağlantılar
PowerShell
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin