Set-WSManInstance (Microsoft.WSMan.Management)

Set-WSManInstance

Modül:

Microsoft.WSMan.Management

Bir kaynakla ilgili yönetim bilgilerini değiştirir.

Sözdizimi

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

Tanım

Set-WSManInstance cmdlet'i, bir kaynakla ilgili yönetim bilgilerini değiştirir.

Bu cmdlet, bilgileri değiştirmek için WinRM bağlantı/aktarım katmanını kullanır.

Örnekler

Örnek 1: Yerel bilgisayardaki bir dinleyiciyi devre dışı bırakın

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 bilgisayardaki HTTPS dinleyicisini devre dışı bırakı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 bilgisayardaki maksimum zarf boyutunu ayarlayın

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 bilgisayardaki MaxEnvelopeSizekb değerini 200 olarak ayarlar.

Ö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 bilgisayardaki dinleyiciyi devre dışı bırakın

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 bilgisayar SERVER02'deki HTTPS dinleyicisini devre dışı bırakı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 WSMAN ayarı çoğu kullanıma uygundur. Bu parametre, çok sayıda bilgisayar Windows PowerShell çalıştıran bir bilgisayara uzaktan bağlantı kurduğunda kullanılmak üzere tasarlanmıştır. Bu durumda IIS, verimlilik amacıyla Yönetim için Web Hizmetlerini (WS-Yönetim) barındırır.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

Wsman

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Authentication

Sunucuda kullanılacak kimlik doğrulama mekanizmasını belirtir. Olası değerler şunlardır:

• Temel: Temel, kullanıcı adı ve şifrenin sunucuya veya proxy'ye açık metin olarak gönderildiği bir şemadır.
• Varsayılan : WS-Management protokolü tarafından uygulanan kimlik doğrulama yöntemini kullanın. Bu varsayılandır.
• Digest: Digest, sorgulama için sunucu tarafından belirlenen bir veri dizesini kullanan bir sorgulama-yanıt şemasıdır.
• Kerberos: İstemci bilgisayar ve sunucu, Kerberos sertifikalarını kullanarak karşılıklı olarak kimlik doğrulaması yapar.
• Anlaşma: Anlaşma, kimlik doğrulama için kullanılacak şemayı belirlemek üzere sunucu veya proxy ile anlaşan bir sorgulama-yanıt şemasıdır. Örneğin, bu parametre değeri, Kerberos protokolünün mü yoksa NTLM'nin mi kullanıldığını belirlemek için anlaşma yapılmasına olanak tanır.
• CredSSP: Kullanıcının kimlik bilgilerini devretmesine olanak tanıyan Kimlik Bilgisi Güvenliği Destek Sağlayıcısı (CredSSP) kimlik doğrulamasını kullanın. Bu seçenek, uzak bir bilgisayarda çalışan ancak diğer uzak bilgisayarlardan veri toplayan veya ek komutlar çalıştıran komutlar için tasarlanmıştır.

Tip :

AuthenticationMechanism

Takma adlar:

auth, am

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-CertificateThumbprint

Bu eylemi gerçekleştirme iznine sahip 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ğrulamada kullanılır. Yalnızca yerel kullanıcı hesaplarıyla eşlenebilirler; etki alanı hesaplarıyla çalışmazlar.

Sertifika parmak izi almak için PowerShell Cert: sürücüsündeki Get-Item veya Get-ChildItem komutunu kullanın.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

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 bir noktayı (.) kullanın. Yerel bilgisayar varsayılandır.

Uzak bilgisayar kullanıcıdan farklı bir etki alanında olduğunda, tam nitelikli bir etki alanı adı kullanmanız gerekir. Bu parametre için bir değeri cmdlet'e aktarabilirsiniz.

Tip :

String

Takma adlar:

cn

Konum:

Adlandırılmış

Varsayılan değer:

Yerel ana bilgisayar

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ConnectionURI

Bağlantı uç noktasını belirtir. Bu dizenin formatı şöyledir:

<Transport>://<Server>:<Port>/<ApplicationName>

Aşağıdaki dize bu parametre için uygun şekilde biçimlendirilmiş bir değerdir:

http://Server01:8080/WSMAN

URI tam olarak nitelenmiş olmalıdır.

Tip :

Uri

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Credential

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabını belirtir. Varsayılan geçerli kullanıcıdır. Kullanıcı01, EtkiAlanı01\Kullanıcı01 veya Kullanıcı@Alan.com gibi bir kullanıcı adı yazın. Alternatif olarak, Get-Credential cmdlet'inin döndürdüğü gibi bir PSCredential nesnesi girin. Kullanıcı adını yazdığınızda sizden şifre istenecektir.

Tip :

PSC kimlik bilgisi

Takma adlar:

cred, c

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Dialect

Filtre yükleminde kullanılacak lehçeyi belirtir. Bu, uzak hizmet tarafından desteklenen herhangi bir lehçe olabilir. Lehçe URI'si için aşağıdaki takma adlar kullanılabilir:

• WQL: http://schemas.microsoft.com/wbem/wsman/1/WQL
• Seçici: http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• İlişkilendirme: http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Tip :

Uri

Konum:

Adlandırılmış

Varsayılan değer:

http://schemas.microsoft.com/wbem/wsman/1/WQL

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-FilePath

Bir yönetim kaynağını güncellemek için kullanılan dosyanın yolunu belirtir. Yönetim kaynağını ResourceURI parametresini ve SelectorSet parametresini kullanarak 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. Input.xml dosyası 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" />

Tip :

String

Takma adlar:

Path

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Fragment

Belirtilen işlem için güncellenecek veya alınacak örnek içindeki bir bölümü belirtir. Örneğin, bir biriktirici hizmetinin durumunu almak için -Fragment Durumu'nu belirtin.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-OptionSet

İsteğin doğasını değiştirmek veya iyileştirmek için bir hizmete bir dizi anahtar iletir. Bunlar, hizmete özel oldukları için komut satırı kabuklarında kullanılan anahtarlara benzer. Herhangi bir sayıda seçenek belirtilebilir.

Aşağıdaki örnek, a, için 1, 2 ve 3 değerlerini ileten söz dizimini gösterir. >b ve c parametreleri:

-OptionSet @{a=1;b=2;c=3}

Tip :

Karma tablo

Takma adlar:

os

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

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'tür.

Aktarım olarak HTTPS'yi kullandığınızda BilgisayarAdı 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üvenilir makineler için kullanılmalıdır.

Tip :

Int32

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ResourceURI

Kaynak sınıfının veya örneğinin Tekdüzen Kaynak Tanımlayıcısını (URI) içerir. URI, bilgisayardaki diskler veya işlemler gibi belirli bir kaynak türünü tanımlamak için kullanılır.

Bir URI, bir önek ve bir kaynağa giden yoldan 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

Tip :

Uri

Takma adlar:

ruri

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

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 tablosu olmalıdır. Aşağıdaki örnek, bu parametre için nasıl değer girileceğini gösterir:

-SelectorSet @{Name="WinRM";ID="yyy"}

Tip :

Karma tablo

Konum:

1

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-SessionOption

WS-Management oturumu için bir dizi genişletilmiş seçeneği tanımlar. New-WSManSessionOption cmdlet'iyle oluşturduğunuz bir SessionOption nesnesini girin. Kullanılabilir seçenekler hakkında daha fazla bilgi için bkz. New-WSManSessionOption.

Tip :

SessionOption

Takma adlar:

so

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-UseSSL

Uzak bilgisayarla bağlantı kurmak için Güvenli Yuva Katmanı (SSL) protokolünün 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 portta SSL yoksa ve bu parametreyi belirtirseniz komut başarısız olur.

Tip :

SwitchParameter

Takma adlar:

ssl

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ValueSet

Bir yönetim kaynağının değiştirilmesine yardımcı olan bir karma tablosu belirtir. Yönetim kaynağını ResourceURI parametresini ve SelectorSet parametresini kullanarak belirtirsiniz. ValueSet parametresinin değeri bir karma tablosu olmalıdır.

Tip :

Karma tablo

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

Girişler

Yok

Nesneleri bu cmdlet'e aktaramazsınız.

Çıkışlar

XmlElement

Bu cmdlet, güncellenmiş WSMan örneğini bir XmlElement nesnesi olarak döndürür.