Connect-WSMan
Uzak bir bilgisayardaki WinRM hizmetine bağlanır.
Syntax
ComputerName (Varsayılan)
Connect-WSMan
[[-ComputerName] <String>]
[-ApplicationName <String>]
[-OptionSet <Hashtable>]
[-Port <Int32>]
[-SessionOption <SessionOption>]
[-UseSSL]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
URI
Connect-WSMan
[-ConnectionURI <Uri>]
[-OptionSet <Hashtable>]
[-Port <Int32>]
[-SessionOption <SessionOption>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Description
Connect-WSMan cmdlet'i uzak bir bilgisayardaki WinRM hizmetine bağlanır ve uzak bilgisayara kalıcı bir bağlantı kurar. Bu cmdlet'i WSMan sağlayıcısı bağlamında kullanarak uzak bilgisayardaki WinRM hizmetine bağlanabilirsiniz. Ancak, WSMan sağlayıcısına geçmeden önce uzak bir bilgisayardaki WinRM hizmetine bağlanmak için de bu cmdlet'i kullanabilirsiniz. Uzak bilgisayar, WSMan sağlayıcısının kök dizininde görünür.
İstemci ve sunucu bilgisayarları farklı etki alanlarında veya çalışma gruplarında olduğunda açık kimlik bilgileri gereklidir.
Uzak bilgisayardaki WinRM hizmetinin bağlantısını kesme hakkında bilgi için Disconnect-WSMan cmdlet'ine bakın.
Örnekler
Örnek 1: Uzak bilgisayara bağlanma
PS C:\> Connect-WSMan -ComputerName "server01"
PS C:\> cd WSMan:
PS WSMan:\>
PS WSMan:\> dir
WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName Type
------------ ----
localhost Container
server01 Container
Bu komut uzak sunucu01 bilgisayara bir bağlantı oluşturur.
Connect-WSMan cmdlet'i genellikle uzak bir bilgisayara bağlanmak için WSMan sağlayıcısı bağlamında kullanılır; bu durumda sunucu01 bilgisayarı. Ancak, WSMan sağlayıcısına geçmeden önce uzak bilgisayarlara bağlantı kurmak için cmdlet'ini kullanabilirsiniz. Bu bağlantılar ComputerName listesinde görünür.
Örnek 2: Yönetici kimlik bilgilerini kullanarak uzak bilgisayara bağlanma
PS C:\> $cred = Get-Credential Administrator
PS C:\> Connect-WSMan -ComputerName "server01" -Credential $cred
PS C:\> cd WSMan:
PS WSMan:\>
PS WSMan:\> dir
WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName Type
------------ ----
localhost Container
server01 Container
Bu komut, Yönetici hesabı kimlik bilgilerini kullanarak uzak sistem sunucusu01'e bir bağlantı oluşturur.
İlk komut, Yönetici kimlik bilgilerini almak için Get-Credential cmdlet'ini kullanır ve bunları $cred değişkeninde depolar.
Get-Credential, sistem kayıt defteri ayarlarına bağlı olarak bir iletişim kutusu aracılığıyla veya komut satırından sizden kullanıcı adı ve parola parolası ister.
İkinci komut, $cred'da depolanan kimlik bilgilerini geçirmek için Connect-WSMan parametresini kullanır.
Connect-WSMan ardından Yönetici kimlik bilgilerini kullanarak uzak sistem sunucusu01'e bağlanır.
Örnek 3: Belirtilen bağlantı noktası üzerinden uzak bilgisayara bağlanma
PS C:\> Connect-WSMan -ComputerName "server01" -Port 80
PS C:\> cd WSMan:
PS WSMan:\>
PS WSMan:\> dir
WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName Type
------------ ----
localhost Container
server01 Container
Bu komut, 80 numaralı bağlantı noktası üzerinden uzak sunucu01 bilgisayara bir bağlantı oluşturur.
Örnek 4: Bağlantı seçeneklerini kullanarak uzak bilgisayara bağlanma
PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd WSMan:
PS WSMan:\> dir
WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName Type
------------ ----
localhost Container
server01 Container
Bu örnek, New-WSManSessionOption komutunda tanımlanan bağlantı seçeneklerini kullanarak uzak sunucu01 bilgisayara bir bağlantı oluşturur.
İlk komut, New-WSManSessionOption değişkeninde bir dizi bağlantı ayarı seçeneğini depolamak için $a kullanır. Bu durumda oturum seçenekleri 30 saniyelik (30.000 milisaniye) bir bağlantı süresi ayarlar.
İkinci komut, değişkeninde depolanan kimlik bilgilerini $ageçirmek için Connect-WSMan parametresini kullanır. Ardından, Connect-WSMan belirtilen oturum seçeneklerini kullanarak uzak sunucu01 bilgisayara bağlanır.
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 Hizmetlerini (WS-Management) barındırmaktadır.
Parametre özellikleri
| Tür: | String |
| 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 |
-Authentication
Sunucuda kullanılacak kimlik doğrulama mekanizmasını belirtir. Bu parametre için kabul edilebilir 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 sunucuda 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ş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ı 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 |
| Kabul edilen değerler: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
| 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 Windows PowerShell Cert: sürücüsündeki Get-Item veya Get-ChildItem 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ş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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Çin |
Parametre kümeleri
ComputerName
| Position: | 0 |
| 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 aşağıdaki gibidir:
<Transport>://<Server>:<Port>/<ApplicationName>
Aşağıdaki dize, bu parametre için doğru 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. Veya cmdlet'i tarafından döndürülen bir nesne gibi Get-Credential nesnesi girin. Bir kullanıcı adı yazdığınızda, bu cmdlet sizden parola ister.
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 |
-OptionSet
İsteğin niteliğini değiştirmek veya iyileştirmek için bir hizmete geçiş kümesi belirtir. 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, a, b ve c parametreleri için 1, 2 ve 3 değerlerini geçiren söz dizimini gösterir:
-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 bilgisayarlar için kullanılmalıdır.
Parametre özellikleri
| Tür: | Int32 |
| 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 |
-SessionOption
WS-Management oturumu için genişletilmiş seçenekleri belirtir.
cmdlet'ini kullanarak oluşturduğunuz bir New-WSManSessionOption nesnesi girin. Kullanılabilen seçenekler hakkında daha fazla bilgi için Get-Help New-WSManSessionOptionyazın.
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ı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.
Parametre özellikleri
| Tür: | SwitchParameter |
| 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 |
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
None
Bu cmdlet çıkış döndürmez.
Notlar
WS-Management oturumu oluşturmadan uzak bir bilgisayarda yönetim komutları veya sorgu yönetimi verileri çalıştırabilirsiniz. Bunu, ve Invoke-WSManActionGet-WSManInstance parametrelerini kullanarak yapabilirsiniz.
ComputerName parametresini kullandığınızda, Windows PowerShell tek komut için kullanılan geçici bir bağlantı oluşturur. Komut çalıştırıldıktan sonra bağlantı kapatılır.
