Test-WSMan
WinRM hizmetinin yerel veya uzak bir bilgisayarda çalışıp çalışmadığını test eder.
Sözdizimi
Test-WSMan
[[-ComputerName] <String>]
[-Authentication <AuthenticationMechanism>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-Credential <PSCredential>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Description
Cmdlet, Test-WSMan
WinRM hizmetinin yerel veya uzak bir bilgisayarda çalışıp çalışmadığını belirleyen bir tanımlama isteği gönderir. Test edilen bilgisayar hizmeti çalıştırıyorsa, cmdlet WS-Management kimlik şemasını, protokol sürümünü, ürün satıcısını ve test edilen hizmetin ürün sürümünü görüntüler.
Örnekler
Örnek 1: WinRM hizmetinin durumunu belirleme
Test-WSMan
Bu komut, WinRM hizmetinin yerel bilgisayarda mı yoksa uzak bir bilgisayarda mı çalıştığını belirler.
Örnek 2: Uzak bilgisayardaki WinRM hizmetinin durumunu belirleme
Test-WSMan -ComputerName "server01"
Bu komut, WinRM hizmetinin server01 bilgisayarında çalışıp çalışmadığını belirler.
Örnek 3: WinRM hizmetinin ve işletim sistemi sürümünün durumunu belirleme
Test-WSMan -Authentication default
Bu komut, kimlik doğrulama parametresini kullanarak WS-Management (WinRM) hizmetinin yerel bilgisayarda çalışıp çalışmadığını test eder.
Kimlik doğrulama parametresinin kullanılması işletim sistemi sürümünü döndürmeye olanak tanır Test-WSMan
.
Örnek 4: Uzak bilgisayardaki WinRM hizmetinin ve işletim sistemi sürümünün durumunu belirleme
Test-WSMan -ComputerName "server01" -Authentication default
Bu komut, kimlik doğrulama parametresini kullanarak sunucu01 adlı bilgisayarda WS-Management (WinRM) hizmetinin çalışıp çalışmadığını test eder.
Kimlik doğrulama parametresinin kullanılması işletim sistemi sürümünü döndürmeye olanak tanır Test-WSMan
.
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. WSMAN'ın bu varsayılan ayarı çoğu kullanım için uygundur. Bu parametre, birçok bilgisayar Windows PowerShell çalıştıran bir bilgisayara uzak bağlantılar kurarsa 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.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Authentication
Sunucuda kullanılacak kimlik doğrulama mekanizmasını belirtir. Bu parametrenin kabul edilebilir değerleri ş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.- 1 - Ö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şma sağlayan bir sınama yanıtı şemasıdır. Ö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ına olanak tanıyan Kimlik Bilgisi Güvenlik Desteği 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ı 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.
Önemli
Authentication parametresini belirtmezseniz, Test-WSMan
istek kimlik doğrulaması kullanılmadan uzak bilgisayara anonim olarak gönderilir. İstek anonim olarak yapılırsa, işletim sistemi sürümüne özgü hiçbir bilgi döndürmez. Bunun yerine, bu cmdlet işletim sistemi sürümü ve hizmet paketi düzeyi (işletim sistemi: 0.0.0 SP: 0.0) için null değerler görüntüler.
Tür: | AuthenticationMechanism |
Diğer adlar: | auth, am |
Kabul edilen değerler: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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 Windows PowerShell Cert: sürücüsündeki Get-Item veya Get-ChildItem
komutunu kullanın.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ComputerName
Yönetim işleminin çalıştırıldığı bilgisayarı belirtir. Değer tam etki alanı adı, NetBIOS adı veya IP adresi olabilir. Yerel bilgisayar adını kullanın, localhost kullanın veya yerel bilgisayarı belirtmek için nokta (.
) kullanın. Yerel bilgisayar varsayılandır. Uzak bilgisayar kullanıcıdan farklı bir etki alanında olduğunda, tam etki alanı adı kullanmanız gerekir. Bu parametre için bir değeri cmdlet'ine yöneltebilirsiniz.
Tür: | String |
Diğer adlar: | cn |
Position: | 0 |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Credential
Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır. User01, Domain01\User01 veya User@Domain.comgibi bir kullanıcı adı yazın. Alternatif olarak, cmdlet'i tarafından Get-Credential
döndürülen nesne gibi bir PSCredential nesnesi de girin. Bir kullanıcı adı yazdığınızda, bu cmdlet sizden parola ister.
Tür: | PSCredential |
Diğer adlar: | cred, c |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
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'dür.
Aktarım olarak HTTPS kullandığınızda, ComputerName parametresinin değeri sunucunun sertifika ortak adıyla (CN) eşleşmelidir.
Tür: | Int32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-UseSSL
Uzak bilgisayara bağlantı kurmak için Güvenli Yuva Katmanı (SSL) protokolunun kullanıldığını 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.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
None
Bu cmdlet çıkış döndürmez.
Notlar
Varsayılan olarak, Test-WSMan
cmdlet kimlik doğrulaması kullanmadan WinRM hizmetini sorgular ve işletim sistemi sürümüne özgü hiçbir bilgi döndürmez. Bunun yerine, işletim sistemi sürümü ve hizmet paketi düzeyi (işletim sistemi: 0.0.0 SP: 0.0) için null değerler görüntüler.
İlişkili Bağlantılar
PowerShell