Set-WSManInstance
Bir kaynakla ilgili yönetim bilgilerini değiştirir.
Syntax
Set-WSManInstance
[-ApplicationName <String>]
[-ComputerName <String>]
[-Dialect <Uri>]
[-FilePath <String>]
[-Fragment <String>]
[-OptionSet <Hashtable>]
[-Port <Int32>]
[-ResourceURI] <Uri>
[[-SelectorSet] <Hashtable>]
[-SessionOption <SessionOption>]
[-UseSSL]
[-ValueSet <Hashtable>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Set-WSManInstance
[-ConnectionURI <Uri>]
[-Dialect <Uri>]
[-FilePath <String>]
[-Fragment <String>]
[-OptionSet <Hashtable>]
[-ResourceURI] <Uri>
[[-SelectorSet] <Hashtable>]
[-SessionOption <SessionOption>]
[-ValueSet <Hashtable>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Description
cmdlet'i Set-WSManInstance
bir kaynakla ilgili yönetim bilgilerini değiştirir.
Bu cmdlet, bilgileri değiştirmek için WinRM bağlantısı/aktarım katmanını kullanır.
Örnekler
Örnek 1: Yerel bilgisayarda dinleyiciyi devre dışı bırakma
Set-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}
cfg : http://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi : http://www.w3.org/2001/XMLSchema-instance
lang : en-US
Address : *
Transport : HTTPS
Port : 443
Hostname :
Enabled : false
URLPrefix : wsman
CertificateThumbprint :
ListeningOn : {127.0.0.1, 172.30.168.171, ::1, 2001:4898:0:fff:0:5efe:172.30.168.171...}
Bu komut, yerel bilgisayarda HTTPS dinleyicisini devre dışı bırakır.
Önemli
Belirtilen özellikler eşleştirilirken ValueSet parametresi büyük/küçük harfe duyarlıdır.
Örneğin, bu komutta
Bu başarısız olur: -ValueSet @{enabled="False"}
Bu başarılı olur: -ValueSet @{Enabled="False"}
Örnek 2: Yerel bilgisayarda en büyük zarf boyutunu ayarlama
Set-WSManInstance -ResourceURI winrm/config -ValueSet @{MaxEnvelopeSizekb = "200"}
cfg : http://schemas.microsoft.com/wbem/wsman/1/config
lang : en-US
MaxEnvelopeSizekb : 200
MaxTimeoutms : 60000
MaxBatchItems : 32000
MaxProviderRequests : 4294967295
Client : Client
Service : Service
Winrs : Winrs
Bu komut, yerel bilgisayarda MaxEnvelopeSizekb değerini 200 olarak ayarlar.
Önemli
Belirtilen özellikler eşleştirilirken ValueSet parametresi büyük/küçük harfe duyarlıdır.
Örneğin, yukarıdaki komutu kullanarak.
Bu başarısız olur: -ValueSet @{MaxEnvelopeSizeKB ="200"}
Bu başarılı olur: -ValueSet @{MaxEnvelopeSizekb ="200"}
Örnek 3: Uzak bilgisayarda dinleyiciyi devre dışı bırakma
Set-WSManInstance -ResourceURI winrm/config/listener -ComputerName SERVER02 -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}
cfg : http://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi : http://www.w3.org/2001/XMLSchema-instance
lang : en-US
Address : *
Transport : HTTPS
Port : 443
Hostname :
Enabled : false
URLPrefix : wsman
CertificateThumbprint :
ListeningOn : {127.0.0.1, 172.30.168.172, ::1, 2001:4898:0:fff:0:5efe:172.30.168.172...}
Bu komut, uzak bilgisayardaki HTTPS dinleyicisini SERVER02 devre dışı bırakır.
Önemli
Belirtilen özellikler eşleştirilirken ValueSet parametresi büyük/küçük harfe duyarlıdır.
Örneğin, yukarıdaki komutu kullanarak.
Bu başarısız olur: -ValueSet @{enabled="False"}
Bu başarılı olur: -ValueSet @{Enabled="False"}
Parametreler
-ApplicationName
Bağlantıdaki uygulama adını belirtir. ApplicationName parametresinin varsayılan değeri "WSMAN"dır. Uzak uç noktanın tam tanımlayıcısı aşağıdaki biçimdedir:
<transport>://<server>:<port>/<ApplicationName>
Örneğin:
http://server01:8080/WSMAN
Oturumu barındıran Internet Information Services (IIS), bu uç nokta ile istekleri belirtilen uygulamaya iletir. bu varsayılan ayarı WSMAN
çoğu kullanım için uygundur. Bu parametre, çok sayıda bilgisayar Windows PowerShell çalıştıran bir bilgisayara uzak bağlantılar kurduğunda kullanılacak şekilde tasarlanmıştır. Bu durumda IIS, verimlilik için Yönetim için Web Hizmetleri'ni (WS-Management) barındırmaktadır.
Type: | String |
Position: | Named |
Default value: | Wsman |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Authentication
Sunucuda kullanılacak kimlik doğrulama mekanizmasını belirtir. Olası değerler şunlardır:
Basic
: Temel, kullanıcı adı ve parolanın sunucuya veya ara sunucuya düz metin olarak gönderildiği bir düzendir.Default
: WS-Management protokolü tarafından uygulanan kimlik doğrulama yöntemini kullanın. Bu varsayılan seçenektir.Digest
: Özet, sınama için sunucu tarafından belirtilen bir veri dizesi kullanan bir sınama yanıtı düzenidir.Kerberos
: İstemci bilgisayar ve sunucu, Kerberos sertifikalarını kullanarak karşılıklı olarak kimlik doğrulaması yapar.Negotiate
: Anlaşma, kimlik doğrulaması için kullanılacak düzeni belirlemek üzere sunucu veya ara sunucuyla anlaşmaya varan bir sınama yanıtı düzenidir. Örneğin, bu parametre değeri anlaşmanın Kerberos protokolü mü yoksa NTLM mi kullanıldığını belirlemesine olanak tanır.CredSSP
: Kullanıcının kimlik bilgilerini temsilci olarak atamasını sağlayan Kimlik Bilgisi Güvenlik Destek Sağlayıcısı (CredSSP) kimlik doğrulamasını kullanın. Bu seçenek, bir uzak bilgisayarda çalışan ancak diğer uzak bilgisayarlardan veri toplayan veya başka komutlar çalıştıran komutlar için tasarlanmıştır.
Dikkat
CredSSP, kullanıcının kimlik bilgilerini yerel bilgisayardan uzak bir bilgisayara devreder. Bu uygulama, uzak işlemin güvenlik riskini artırır. Uzak bilgisayarın güvenliği aşılırsa, kimlik bilgileri ona geçirildiğinde, kimlik bilgileri ağ oturumunu denetlemek için kullanılabilir.
Type: | AuthenticationMechanism |
Aliases: | auth, am |
Accepted values: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
Bu eylemi gerçekleştirme izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X509) belirtir. Sertifikanın sertifika parmak izini girin.
Sertifikalar, istemci sertifikası tabanlı kimlik doğrulamasında kullanılır. Bunlar yalnızca yerel kullanıcı hesaplarıyla eşlenebilir; etki alanı hesaplarıyla çalışmaz.
Sertifika parmak izi almak için PowerShell Cert:
sürücüsündeki veya Get-ChildItem
komutunu kullanınGet-Item
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Yönetim işlemini çalıştırmak istediğiniz bilgisayarı belirtir. Değer tam etki alanı adı, NetBIOS adı veya IP adresi olabilir. Yerel bilgisayarı belirtmek için yerel bilgisayar adını, localhost
veya nokta (.
) kullanın. Yerel bilgisayar varsayılandır.
Uzak bilgisayar kullanıcıdan farklı bir etki alanındaysa, tam etki alanı adı kullanmanız gerekir. Bu parametre için bir değeri cmdlet'ine yöneltebilirsiniz.
Type: | String |
Aliases: | cn |
Position: | Named |
Default value: | Localhost |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionURI
Bağlantı uç noktasını belirtir. Bu dizenin biçimi:
<Transport>://<Server>:<Port>/<ApplicationName>
Aşağıdaki dize, bu parametre için düzgün biçimlendirilmiş bir değerdir:
http://Server01:8080/WSMAN
URI tam olarak nitelenmiş olmalıdır.
Type: | Uri |
Position: | Named |
Default value: | None |
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. , Domain01\User01
veya User@Domain.com
gibi User01
bir kullanıcı adı yazın. Alternatif olarak, cmdlet'i tarafından Get-Credential
döndürülen nesne gibi bir PSCredential nesnesi girin. Bir kullanıcı adı yazdığınızda parola girmeniz istenir.
Type: | PSCredential |
Aliases: | cred, c |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Dialect
Filtre koşulunda kullanılacak diyalekt belirtir. Bu, uzak hizmet tarafından desteklenen herhangi bir diyalekt olabilir. Diyalekt URI'sinde aşağıdaki diğer adlar kullanılabilir:
WQL
:http://schemas.microsoft.com/wbem/wsman/1/WQL
Selector
:http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
Association
:http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter
Type: | Uri |
Position: | Named |
Default value: | http://schemas.microsoft.com/wbem/wsman/1/WQL |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FilePath
Bir yönetim kaynağını güncelleştirmek için kullanılan dosyanın yolunu belirtir. ResourceURI parametresini ve SelectorSet parametresini kullanarak yönetim kaynağını belirtirsiniz. Örneğin, aşağıdaki komut FilePath parametresini kullanır:
Invoke-WSManAction -Action StopService -ResourceUri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:c:\input.xml -authentication default
Bu komut, bir dosyadaki girişi kullanarak Biriktirici hizmetindeki StopService yöntemini çağırır.
dosyası Input.xml
aşağıdaki içeriği içerir:
<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Fragment
Örneğin içinde, belirtilen işlem için güncelleştirilecek veya alınacak bir bölüm belirtir. Örneğin, bir biriktirici hizmetinin durumunu almak için belirtin -Fragment Status
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OptionSet
İsteğin niteliğini değiştirmek veya iyileştirmek için bir dizi anahtarı bir hizmete geçirir. Bunlar, hizmete özgü olduklarından komut satırı kabuklarında kullanılan anahtarlara benzer. Herhangi bir sayıda seçenek belirtilebilir.
Aşağıdaki örnek, , ve c
parametreleri için , 2
ve 3
değerlerini 1
geçiren söz dizimini a
b
gösterir:
-OptionSet @{a=1;b=2;c=3}
Type: | Hashtable |
Aliases: | os |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
İstemci WinRM hizmetine bağlandığında kullanılacak bağlantı noktasını belirtir. Aktarım HTTP olduğunda varsayılan bağlantı noktası 80'dir. Aktarım HTTPS olduğunda varsayılan bağlantı noktası 443'dür.
Aktarım olarak HTTPS kullandığınızda, ComputerName parametresinin değeri sunucunun sertifika ortak adıyla (CN) eşleşmelidir. Ancak, SkipCNCheck parametresi SessionOption parametresinin bir parçası olarak belirtilirse, sunucunun sertifika ortak adının sunucunun ana bilgisayar adıyla eşleşmesi gerekmez. SkipCNCheck parametresi yalnızca güvenilen makineler için kullanılmalıdır.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceURI
Kaynak sınıfının veya örneğin Tekdüzen Kaynak Tanımlayıcısını (URI) içerir. URI, bir bilgisayardaki diskler veya işlemler gibi belirli bir kaynak türünü tanımlamak için kullanılır.
URI bir ön ek ve kaynağın yolundan oluşur. Örneğin:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor
Type: | Uri |
Aliases: | ruri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SelectorSet
Belirli yönetim kaynağı örneklerini seçmek için kullanılan değer çiftleri kümesini belirtir. SelectorSet parametresi, kaynağın birden fazla örneği mevcut olduğunda kullanılır. SelectorSet parametresinin değeri bir karma tablo olmalıdır. Aşağıdaki örnekte bu parametre için bir değerin nasıl girilir gösterilmektedir:
-SelectorSet @{Name="WinRM";ID="yyy"}
Type: | Hashtable |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SessionOption
WS-Management oturumu için bir dizi genişletilmiş seçenek tanımlar. cmdlet'iyle New-WSManSessionOption
oluşturduğunuz bir SessionOption nesnesi girin. Kullanılabilir seçenekler hakkında daha fazla bilgi için bkz . New-WSManSessionOption.
Type: | SessionOption |
Aliases: | so |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSSL
Uzak bilgisayara bağlantı kurmak için Güvenli Yuva Katmanı (SSL) protokolunun kullanılması gerektiğini belirtir. Varsayılan olarak SSL kullanılmaz.
WS-Management, ağ üzerinden iletilen tüm Windows PowerShell içeriğini şifreler. UseSSL parametresi, HTTP yerine HTTPS'nin ek korumasını belirtmenize olanak tanır. Bağlantı için kullanılan bağlantı noktasında SSL kullanılamıyorsa ve bu parametreyi belirtirseniz, komut başarısız olur.
Type: | SwitchParameter |
Aliases: | ssl |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValueSet
Bir yönetim kaynağının değiştirilmesine yardımcı olan bir karma tablo belirtir. ResourceURI parametresini ve SelectorSet parametresini kullanarak yönetim kaynağını belirtirsiniz. ValueSet parametresinin değeri bir karma tablo olmalıdır.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
None
Bu cmdlet çıkış döndürmez.
İlişkili Bağlantılar
PowerShell
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Ç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.Gönderin ve geri bildirimi görüntüleyin