Set-WSManInstance

Modül:

Microsoft.WSMan.Management Module

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

Syntax

ComputerName (Varsayılan)

Set-WSManInstance
    [-ResourceURI] <Uri>
    [[-SelectorSet] <Hashtable>]
    [-ApplicationName <String>]
    [-ComputerName <String>]
    [-Dialect <Uri>]
    [-FilePath <String>]
    [-Fragment <String>]
    [-OptionSet <Hashtable>]
    [-Port <Int32>]
    [-SessionOption <SessionOption>]
    [-UseSSL]
    [-ValueSet <Hashtable>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

URI

Set-WSManInstance
    [-ResourceURI] <Uri>
    [[-SelectorSet] <Hashtable>]
    [-ConnectionURI <Uri>]
    [-Dialect <Uri>]
    [-FilePath <String>]
    [-Fragment <String>]
    [-OptionSet <Hashtable>]
    [-SessionOption <SessionOption>]
    [-ValueSet <Hashtable>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Description

Set-WSManInstance cmdlet'i 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

$params = @{
    ResourceURI = 'winrm/config/listener'
    SelectorSet = @{address = '*'; transport = 'https'}
    ValueSet    = @{Enabled = 'false'}
}
Set-WSManInstance @params

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

ValueSet parametresi, belirtilen özellikler eşleştirilirken büyük/küçük harfe duyarlıdır.

Örneğin, bu komutta

Bu başarısız oluyor: -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, MaxEnvelopeSizekb değerini yerel bilgisayarda 200 olarak ayarlar.

Önemli

ValueSet parametresi, belirtilen özellikler eşleştirilirken büyük/küçük harfe duyarlıdır.

Örneğin, yukarıdaki komutu kullanarak.

Bu başarısız oluyor: -ValueSet @{MaxEnvelopeSizeKB ="200"}

Bu başarılı olur: -ValueSet @{MaxEnvelopeSizekb ="200"}

Örnek 3: Uzak bilgisayarda dinleyiciyi devre dışı bırakma

$params = @{
    ResourceURI  = 'winrm/config/listener'
    ComputerName = 'SERVER02'
    SelectorSet  = @{address = '*'; transport = 'https'}
    ValueSet     = @{Enabled = 'false'}
}
Set-WSManInstance @params

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

ValueSet parametresi, belirtilen özellikler eşleştirilirken büyük/küçük harfe duyarlıdır.

Örneğin, yukarıdaki komutu kullanarak.

Bu başarısız oluyor: -ValueSet @{enabled="False"}

Bu başarılı olur: -ValueSet @{Enabled="False"}

Örnek 4: Giriş dosyası kullanarak kaynağı yönetme

Aşağıdaki komut, bir yönetim kaynağını güncelleştirmek için FilePath parametresini kullanır. ResourceURI ve SelectorSet parametrelerini kullanarak yönetim kaynağını belirtin.

$params = @{
    Action         = 'StopService'
    ResourceUri    = 'wmicimv2/Win32_Service'
    SelectorSet    = @{Name = 'spooler'}
    FilePath       = 'C:\input.xml'
    Authentication = 'Default'
}
Invoke-WSManAction @params

Bu komut, bir dosyadan giriş kullanarak Biriktirici hizmetindeki StopService yöntemini çağırır. Dosya 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" />

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ı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 Hizmetlerini (WS-Management) barındırmaktadır.

Parametre özellikleri

Tür:	String
Default value:	Wsman
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ComputerName

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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. Varsayılan değer budur.
• Digest: Özet, sınama için sunucu tarafından belirtilen veri dizesini 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şma sağlayan 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.

Parametre özellikleri

Tür:	AuthenticationMechanism
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	yetkilendirme, am

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-CertificateThumbprint

Bu eylemi gerçekleştirme izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X509) belirtir. Sertifikanın 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 Get-Item sürücüsündeki Get-ChildItem veya Cert: komutunu kullanın.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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ı, localhostveya 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.

Parametre özellikleri

Tür:	String
Default value:	Localhost
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Çin

Parametre kümeleri

ComputerName

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	Uri
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

URI

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Credential

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Varsayılan değer mevcut kullanıcıdır. User01, Domain01\User01veya User@Domain.comgibi bir kullanıcı adı yazın. Alternatif olarak, cmdlet'i tarafından döndürülen nesne gibi Get-Credential nesnesi girin. Bir kullanıcı adı yazdığınızda parola girmeniz istenir.

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	cred, c

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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

Parametre özellikleri

Tür:	Uri
Default value:	http://schemas.microsoft.com/wbem/wsman/1/WQL
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-FilePath

Bir yönetim kaynağını güncelleştirmek için kullanılan dosyanın yolunu belirtir. Daha fazla bilgi için bkz . Örnek 4.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Yol

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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 -Fragment Statusbelirtin.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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 örnekte, 1, 2ve 3 parametreleri için a, bve c değerlerini geçiren söz dizimi gösterilmektedir:

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

Parametre özellikleri

Tür:	Hashtable
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	os

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	Int32
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ComputerName

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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

Parametre özellikleri

Tür:	Uri
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	ruri

Parametre kümeleri

(All)

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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 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"}

Parametre özellikleri

Tür:	Hashtable
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SessionOption

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

Parametre özellikleri

Tür:	SessionOption
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	böyle

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	SSL (İngilizce)

Parametre kümeleri

ComputerName

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ValueSet

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

Parametre özellikleri

Tür:	Hashtable
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

XmlElement

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

İlişkili Bağlantılar

• Connect-WSMan
• Disable-WSManCredSSP
• Bağlantıyı Kes-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Get-WSManInstance
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption (Yeni WSMan Oturum Seçeneği)
• WSManÖrneğiniKaldır
• Set-WSManQuickConfig
• Test-WSMan