Connect-WSMan

Składnia

ComputerName (domyślnie)

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

Opis

Przykłady

Przykład 1. Nawiązywanie połączenia z komputerem zdalnym

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

Przykład 2. Nawiązywanie połączenia z komputerem zdalnym przy użyciu poświadczeń administratora

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

Przykład 3. Nawiązywanie połączenia z komputerem zdalnym za pośrednictwem określonego portu

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

Przykład 4. Nawiązywanie połączenia z komputerem zdalnym przy użyciu opcji połączenia

PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS WSMan:\>
PS WSMan:\> dir
WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Parametry

-ApplicationName

Określa nazwę aplikacji w połączeniu. Wartość domyślna parametru ApplicationName to WSMAN. Pełny identyfikator zdalnego punktu końcowego ma następujący format:

<transport>://<server>:<port>/<ApplicationName>

Przykład: http://server01:8080/WSMAN

Internet Information Services (IIS), który hostuje sesję, przekazuje żądania z tym punktem końcowym do określonej aplikacji. To ustawienie domyślne programu WSMAN jest odpowiednie dla większości zastosowań. Ten parametr jest przeznaczony do użycia, jeśli wiele komputerów nawiązuje połączenia zdalne z jednym komputerem z uruchomionym programem Windows PowerShell. W takim przypadku usługi IIS hostuje usługi sieci Web do zarządzania (WS-Management) w celu zwiększenia wydajności.

Właściwości parametru

Zestawy parametrów

-Authentication

Określa mechanizm uwierzytelniania, który ma być używany na serwerze. Dopuszczalne wartości tego parametru to:

• Podstawowy. Podstawowa to schemat, w którym nazwa użytkownika i hasło są wysyłane w postaci zwykłego tekstu do serwera lub serwera proxy.
• Domyślne. Użyj metody uwierzytelniania zaimplementowanej przez protokół WS-Management. Jest to wartość domyślna.
• Trawić. Skrót to schemat odpowiedzi wyzwania, który używa ciągu danych określonego przez serwer do wyzwania.
• Kerberos. Komputer kliencki i serwer wzajemnie się uwierzytelniają przy użyciu certyfikatów Protokołu Kerberos.
• Negocjować. Negocjowanie to schemat odpowiedzi na żądanie, który negocjuje z serwerem lub serwerem proxy w celu określenia schematu do użycia do uwierzytelniania. Na przykład ta wartość parametru umożliwia negocjowanie w celu określenia, czy jest używany protokół Kerberos, czy NTLM.
• Zaufanie SSP. Użyj uwierzytelniania dostawcy obsługi zabezpieczeń poświadczeń (CredSSP), które umożliwia użytkownikowi delegowanie poświadczeń. Ta opcja jest przeznaczona dla poleceń uruchamianych na jednym komputerze zdalnym, ale zbiera dane z lub uruchamia dodatkowe polecenia na innych komputerach zdalnych.

Uwaga: CredSSP deleguje poświadczenia użytkownika z komputera lokalnego do komputera zdalnego. Ta praktyka zwiększa ryzyko bezpieczeństwa operacji zdalnej. W przypadku naruszenia zabezpieczeń komputera zdalnego po przekazaniu do niego poświadczeń można użyć poświadczeń do kontrolowania sesji sieciowej.

Właściwości parametru

Zestawy parametrów

-CertificateThumbprint

Określa cyfrowy certyfikat klucza publicznego (X509) konta użytkownika, które ma uprawnienia do wykonania tej akcji. Wprowadź odcisk palca certyfikatu.

Certyfikaty są używane w uwierzytelnianiu opartym na certyfikatach klienta. Mogą być mapowane tylko na konta użytkowników lokalnych; nie działają z kontami domeny.

Aby uzyskać odcisk palca certyfikatu, użyj polecenia Get-Item lub Get-ChildItem w dysku Windows PowerShell Cert: .

Właściwości parametru

Zestawy parametrów

-ComputerName

Określa komputer, na którym ma zostać uruchomiona operacja zarządzania. Wartość może być w pełni kwalifikowaną nazwą domeny, nazwą NetBIOS lub adresem IP. Użyj nazwy komputera lokalnego, użyj hosta lokalnego lub użyj kropki (.), aby określić komputer lokalny. Komputer lokalny jest domyślny. Jeśli komputer zdalny znajduje się w innej domenie niż użytkownik, należy użyć w pełni kwalifikowanej nazwy domeny. Do polecenia cmdlet można przekazać wartość tego parametru.

Właściwości parametru

Zestawy parametrów

-ConnectionURI

Określa punkt końcowy połączenia. Format tego ciągu jest następujący:

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

Następujący ciąg jest poprawnie sformatowaną wartością dla tego parametru:

http://Server01:8080/WSMAN

Identyfikator URI musi być w pełni kwalifikowany.

Właściwości parametru

Zestawy parametrów

-Credential

Określa konto użytkownika, które ma uprawnienia do wykonania tej akcji. Wartość domyślna to bieżący użytkownik. Wpisz nazwę użytkownika, taką jak User01, Domain01\User01 lub User@Domain.com. Możesz też wprowadzić obiekt PSCredential, taki jak obiekt zwrócony przez polecenie cmdlet Get-Credential. Po wpisaniu nazwy użytkownika, ten cmdlet wyświetli monit o podanie hasła.

Właściwości parametru

Zestawy parametrów

-OptionSet

Określa zestaw przełączników do usługi w celu zmodyfikowania lub uściślinia charakteru żądania. Te przełączniki przypominają przełączniki używane w powłokach wiersza polecenia, ponieważ są one specyficzne dla usługi. Można określić dowolną liczbę opcji.

W poniższym przykładzie pokazano składnię przekazującą wartości 1, 2 i 3 dla parametrów a, b i c:

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

Właściwości parametru

Zestawy parametrów

-Port

Określa port, który ma być używany, gdy klient nawiązuje połączenie z usługą WinRM. Gdy transport to HTTP, domyślny port to 80. Gdy transport to HTTPS, domyślny port to 443.

W przypadku używania protokołu HTTPS jako transportu wartość parametru ComputerName musi być zgodna z nazwą pospolitą certyfikatu serwera (CN). Jeśli jednak parametr SkipCNCheck jest określony jako część parametru SessionOption, nazwa pospolita certyfikatu serwera nie musi być zgodna z nazwą hosta serwera. Parametr SkipCNCheck powinien być używany tylko dla zaufanych komputerów.

Właściwości parametru

Zestawy parametrów

-SessionOption

Określa opcje rozszerzone dla sesji WS-Management. Wprowadź obiekt SessionOption tworzony przy użyciu polecenia cmdlet New-WSManSessionOption. Aby uzyskać więcej informacji na temat dostępnych opcji, wpisz Get-Help New-WSManSessionOption.

Właściwości parametru

Zestawy parametrów

-UseSSL

Określa, że protokół Secure Sockets Layer (SSL) jest używany do nawiązywania połączenia z komputerem zdalnym. Domyślnie protokół SSL nie jest używany.

WS-Management szyfruje całą zawartość programu Windows PowerShell przesyłaną przez sieć. Parametr UseSSL umożliwia określenie dodatkowej ochrony protokołu HTTPS zamiast protokołu HTTP. Jeśli protokół SSL nie jest dostępny na porcie używanym na potrzeby połączenia i określisz ten parametr, polecenie zakończy się niepowodzeniem.

Właściwości parametru

Zestawy parametrów

CommonParameters

Dane wejściowe

None

Dane wyjściowe

None

Uwagi

Linki powiązane

• Disable-WSManCredSSP (Wyłącz-WSManCredSSP)
• Disconnect-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Get-WSManInstance
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption
• Usuń-WSManInstance
• Set-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan