Поиск по сайту:

Connect-WSMan (Microsoft.WSMan.Management)

Connect-WSMan

Модуль:
Microsoft.WSMan.Management

Подключается к службе WinRM на удаленном компьютере.

Синтаксис

Connect-WSMan
       [-ApplicationName <String>]
       [[-ComputerName] <String>]
       [-OptionSet <Hashtable>]
       [-Port <Int32>]
       [-SessionOption <SessionOption>]
       [-UseSSL]
       [-Credential <PSCredential>]
       [-Authentication <AuthenticationMechanism>]
       [-CertificateThumbprint <String>]
       [<CommonParameters>]
Connect-WSMan
       [-ConnectionURI <Uri>]
       [-OptionSet <Hashtable>]
       [-Port <Int32>]
       [-SessionOption <SessionOption>]
       [-Credential <PSCredential>]
       [-Authentication <AuthenticationMechanism>]
       [-CertificateThumbprint <String>]
       [<CommonParameters>]

Описание

Этот командлет доступен только на платформе Windows.

Командлет Connect-WSMan подключается к службе WinRM на удаленном компьютере и устанавливает постоянное соединение с удаленным компьютером. Этот командлет можно использовать в контексте поставщика WSMan для подключения к службе WinRM на удаленном компьютере. Однако вы также можете использовать этот командлет для подключения к службе WinRM на удаленном компьютере, прежде чем перейти на поставщика WSMan. Удаленный компьютер появится в корневом каталоге поставщика WSMan.

Явные учетные данные необходимы, когда клиентские и серверные компьютеры находятся в разных доменах или рабочих группах.

Сведения о том, как отключиться от службы WinRM на удаленном компьютере, см. в командлете Disconnect-WSMan.

Примеры

Пример 1. Подключение к удаленному компьютеру

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

Эта команда создает соединение с удаленным компьютером server01.

Командлет Connect-WSMan обычно используется в контексте поставщика WSMan для подключения к удаленному компьютеру, в данном случае к компьютеру server01. Однако вы можете использовать этот командлет для установки подключений к удаленным компьютерам до перехода на поставщика WSMan. Эти подключения появятся в списке ComputerName.

Пример 2. Подключение к удаленному компьютеру с использованием учетных данных администратора.

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

Эта команда создает соединение с удаленным системным сервером server01, используя учетные данные учетной записи администратора.

Первая команда использует командлет Get-Credential для получения учетных данных администратора, а затем сохраняет их в переменной $cred. Get-Credential запрашивает пароль из имени пользователя и пароля через диалоговое окно или командную строку, в зависимости от настроек системного реестра.

Вторая команда использует параметр Credential для передачи учетных данных, хранящихся в $cred, в Connect-WSMan. Connect-WSMan затем подключается к удаленному системному серверу server01, используя учетные данные администратора.

Пример 3. Подключение к удаленному компьютеру через указанный порт.

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

Эта команда создает соединение с удаленным компьютером server01 через порт 80.

Пример 4. Подключение к удаленному компьютеру с помощью параметров подключения.

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

В этом примере создается подключение к удаленному компьютеру server01 с использованием параметров подключения, определенных в команде New-WSManSessionOption.

Первая команда использует New-WSManSessionOption для хранения набора параметров настройки соединения в переменной $a. В этом случае в параметрах сеанса установлено время соединения 30 секунд (30 000 миллисекунд).

Вторая команда использует параметр SessionOption для передачи учетных данных, хранящихся в переменной $a, в Connect-WSMan. Затем Connect-WSMan подключается к удаленному компьютеру server01, используя указанные параметры сеанса.

Параметры

-ApplicationName

Указывает имя приложения в соединении. Значением по умолчанию параметра ApplicationName является WSMAN. Полный идентификатор удаленной конечной точки имеет следующий формат:

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

Например:

http://server01:8080/WSMAN

Службы IIS, на которых размещается сеанс, пересылают запросы с этой конечной точки указанному приложению. Эта настройка WSMAN по умолчанию подходит для большинства случаев использования. Этот параметр предназначен для использования, если несколько компьютеров устанавливают удаленные подключения к одному компьютеру под управлением Windows PowerShell. В этом случае для повышения эффективности в IIS размещаются веб-службы управления (WS-Management).

Тип :

String

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Authentication

Указывает механизм аутентификации, который будет использоваться на сервере. Допустимые значения этого параметра:

  • Basic — Basic — это схема, в которой имя пользователя и пароль передаются на сервер или прокси в виде открытого текста.
  • Default — использовать метод аутентификации, реализованный протоколом WS-Management. Это значение по умолчанию.
  • Дайджест. Дайджест — это схема запроса-ответа, в которой для запроса используется строка данных, указанная сервером.
  • Kerberos — клиентский компьютер и сервер выполняют взаимную проверку подлинности с помощью сертификатов Kerberos.
  • Согласование. Согласование — это схема запроса-ответа, которая согласовывает с сервером или прокси-сервером, чтобы определить схему, которая будет использоваться для аутентификации. Например, значение этого параметра позволяет путем согласования определить, используется ли протокол Kerberos или NTLM.
  • CredSSP — используйте аутентификацию поставщика поддержки безопасности учетных данных (CredSSP), которая позволяет пользователю делегировать учетные данные. Этот параметр предназначен для команд, которые выполняются на одном удаленном компьютере, но собирают данные или запускают дополнительные команды на других удаленных компьютерах.

Осторожность

CredSSP делегирует учетные данные пользователя с локального компьютера на удаленный компьютер. Такая практика увеличивает риск безопасности удаленной операции. Если удаленный компьютер взломан, то при передаче ему учетных данных эти учетные данные можно использовать для управления сетевым сеансом.

Тип :

AuthenticationMechanism

Псевдонимы:

auth, am

Принятые значения:

Нет, по умолчанию, дайджест, согласование, базовый, Kerberos, ClientCertificate, Credssp

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-CertificateThumbprint

Указывает сертификат цифрового открытого ключа (X509) учетной записи пользователя, у которой есть разрешение на выполнение этого действия. Введите отпечаток сертификата.

Сертификаты используются при проверке подлинности на основе сертификатов клиентов. Их можно сопоставить только с локальными учетными записями пользователей; они не работают с доменными учетными записями.

Чтобы получить отпечаток сертификата, используйте команду Get-Item или Get-ChildItem на диске Windows PowerShell Cert:.

Тип :

String

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ComputerName

Указывает компьютер, на котором будет выполняться операция управления. Значением может быть полное доменное имя, имя NetBIOS или IP-адрес. Используйте имя локального компьютера, localhost или точку (.), чтобы указать локальный компьютер. Локальный компьютер используется по умолчанию. Если удаленный компьютер находится в домене, отличном от домена пользователя, необходимо использовать полное доменное имя. Вы можете передать значение этого параметра в командлет.

Тип :

String

Псевдонимы:

cn

Позиция:

0

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ConnectionURI

Указывает конечную точку соединения. Формат этой строки следующий:

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

Следующая строка представляет собой правильно отформатированное значение для этого параметра:

http://Server01:8080/WSMAN

URI должен быть полностью квалифицированным.

Тип :

Ури

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Credential

Указывает учетную запись пользователя, имеющую разрешение на выполнение этого действия. По умолчанию используется текущий пользователь. Введите имя пользователя, например User01, Domain01\User01 или User@Domain.com. Или введите объект PSCredential, например тот, который возвращается командлетом Get-Credential. Когда вы вводите имя пользователя, этот командлет запрашивает пароль.

Тип :

PSCredential

Псевдонимы:

cred, c

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-OptionSet

Указывает набор переключателей службы для изменения или уточнения характера запроса. Они напоминают переключатели, используемые в оболочках командной строки, поскольку они зависят от службы. Можно указать любое количество опций.

В следующем примере демонстрируется синтаксис, который передает значения 1, 2 и 3 для параметров a, b и c:

-OptionSet @{a=1;b=2;c=3}
Тип :

Хэш-таблица

Псевдонимы:

os

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Port

Указывает порт, который будет использоваться при подключении клиента к службе WinRM. Если транспортом является HTTP, порт по умолчанию — 80. Если транспортом является HTTPS, порт по умолчанию — 443.

Если вы используете HTTPS в качестве транспорта, значение параметра ComputerName должно соответствовать общему имени сертификата сервера (CN). Однако если параметр SkipCNCheck указан как часть параметра SessionOption, общее имя сертификата сервера не обязательно должно совпадать с именем хоста сервера. Параметр SkipCNCCheck следует использовать только для доверенных компьютеров.

Тип :

Int32

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-SessionOption

Указывает расширенные параметры для сеанса WS-Management. Введите объект SessionOption, созданный с помощью командлета New-WSManSessionOption. Для получения дополнительных сведений о доступных параметрах введите Get-Help New-WSManSessionOption.

Тип :

SessionOption

Псевдонимы:

so

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-UseSSL

Указывает, что для установления соединения с удаленным компьютером используется протокол Secure Sockets Layer (SSL). По умолчанию SSL не используется.

WS-Management шифрует все содержимое Windows PowerShell, передаваемое по сети. Параметр UseSSL позволяет указать дополнительную защиту HTTPS вместо HTTP. Если SSL недоступен на порту, который используется для подключения, и вы укажете этот параметр, команда завершится неудачно.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

Входы

Нет

Вы не можете передавать объекты в этот командлет.

Выходы

Нет

Этот командлет не возвращает никаких результатов.

Примечания

Вы можете запускать команды управления или запрашивать данные управления на удаленном компьютере без создания сеанса WS-Management. Это можно сделать, используя параметры ComputerName Invoke-WSManAction и Get-WSManInstance. Когда вы используете параметр ComputerName, Windows PowerShell создает временное соединение, которое используется для одной команды. После выполнения команды соединение закрывается.