Test-WSMan (Microsoft.WSMan.Management)

Test-WSMan

Modül:

Microsoft.WSMan.Management

WinRM hizmetinin yerel bilgisayarda mı yoksa uzak bilgisayarda mı çalıştığını test eder.

Sözdizimi

Test-WSMan
    [[-ComputerName] <String>]
    [-Authentication <AuthenticationMechanism>]
    [-Port <Int32>]
    [-UseSSL]
    [-ApplicationName <String>]
    [-Credential <PSCredential>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Tanım

Bu cmdlet yalnızca Windows platformunda mevcuttur.

Test-WSMan cmdlet'i, WinRM hizmetinin yerel bilgisayarda mı yoksa uzak bilgisayarda mı çalıştığını belirleyen bir kimlik isteği gönderir. Test edilen bilgisayar hizmeti çalıştırıyorsa cmdlet, WS-Yönetim 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 bilgisayarda mı çalıştığını belirler.

Örnek 2: Uzak bilgisayardaki WinRM hizmetinin durumunu belirleme

Test-WSMan -ComputerName "server01"

Bu komut, WinRM hizmetinin sunucu01 bilgisayarında çalışıp çalışmadığını belirler.

Örnek 3: WinRM hizmetinin durumunu ve işletim sistemi sürümünü 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ı Test-WSMan'in işletim sistemi sürümünü döndürmesini sağlar.

Örnek 4: Uzak bilgisayardaki WinRM hizmetinin durumunu ve işletim sistemi sürümünü belirleme

Test-WSMan -ComputerName "server01" -Authentication default

Bu komut, kimlik doğrulama parametresini kullanarak WS-Management (WinRM) hizmetinin server01 adlı bilgisayarda çalışıp çalışmadığını test eder.

Kimlik doğrulama parametresinin kullanılması Test-WSMan'in işletim sistemi sürümünü döndürmesini sağlar.

Parametreler

-ApplicationName

Bağlantıdaki uygulama adını belirtir. ApplicationName parametresinin varsayılan değeri WSMAN'dir. 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'nin bu varsayılan ayarı çoğu kullanıma uygundur. Bu parametre, birçok bilgisayarın Windows PowerShell çalıştıran bir bilgisayara uzaktan bağlantı kurması durumunda 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:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Authentication

Sunucuda kullanılacak kimlik doğrulama mekanizmasını belirtir. Bu parametre için kabul edilebilir 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.
• 1 - Digest, meydan okuma için sunucu tarafından belirlenen bir veri dizesini kullanan bir meydan okuma-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ın belirlenmesine olanak sağlar.
• 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

Kabul edilen değerler:

Yok, Varsayılan, Özet, Anlaşma, Temel, Kerberos, ClientCertificate, Credssp

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 Windows 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şleminin çalıştırılacağı bilgisayarı belirtir. Değer, tam etki alanı adı, NetBIOS adı veya IP adresi olabilir. Yerel bilgisayarı belirtmek için yerel bilgisayar adını kullanın, localhost kullanın veya bir nokta (.) 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ı kullanılmalıdır. Bu parametre için bir değeri cmdlet'e aktarabilirsiniz.

Tip :

String

Takma adlar:

cn

Konum:

0

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

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, Etki Alanı01\Kullanıcı01 veya Kullanıcı@Alan.com gibi bir kullanıcı adı yazın. Veya Get-Credential cmdlet'inin döndürdüğü gibi bir PSCredential nesnesi girin. Bir kullanıcı adı yazdığınızda bu cmdlet sizden bir parola ister.

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

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

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

-UseSSL

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

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Yok

Nesneleri bu cmdlet'e aktaramazsınız.

Çıkışlar

XmlElement

Bu cmdlet, testin sonucunu temsil eden bir XmlElement nesnesini döndürür.

Notlar

Varsayılan olarak Test-WSMan cmdlet'i, kimlik doğrulama kullanmadan WinRM hizmetini sorgular ve işletim sistemi sürümüne özel hiçbir bilgi döndürmez. Bunun yerine, işletim sistemi sürümü ve hizmet paketi düzeyi (OS: 0.0.0 SP: 0.0) için boş değerler görüntüler.