Enter-PSSession
Запускает интерактивный сеанс с удаленным компьютером.
Синтаксис
Enter-PSSession
[-ComputerName] <String>
[-EnableNetworkAccess]
[-Credential <PSCredential>]
[-ConfigurationName <String>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]Enter-PSSession
[[-Session] <PSSession>]
[<CommonParameters>]Enter-PSSession
[[-ConnectionUri] <Uri>]
[-EnableNetworkAccess]
[-Credential <PSCredential>]
[-ConfigurationName <String>]
[-AllowRedirection]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]Enter-PSSession
[-InstanceId <Guid>]
[<CommonParameters>]Enter-PSSession
[[-Id] <Int32>]
[<CommonParameters>]Enter-PSSession
[-Name <String>]
[<CommonParameters>]Enter-PSSession
[-VMId] <Guid>
-Credential <PSCredential>
[-ConfigurationName <String>]
[<CommonParameters>]Enter-PSSession
[-VMName] <String>
-Credential <PSCredential>
[-ConfigurationName <String>]
[<CommonParameters>]Enter-PSSession
[-ContainerId] <String>
[-ConfigurationName <String>]
[-RunAsAdministrator]
[<CommonParameters>]Описание
Командлет Enter-PSSession запускает интерактивный сеанс с одним удаленным компьютером. Во время сеанса команды, которые вы вводите на удаленном компьютере, так же, как если бы вы вводили непосредственно на удаленном компьютере. В один интерактивный сеанс можно одновременно использовать только один интерактивный сеанс.
Как правило, для указания имени удаленного компьютера используется параметр ComputerName.
Однако можно также использовать сеанс, создаваемый с помощью командлета New-PSSession для интерактивного сеанса. Однако нельзя использовать командлеты Disconnect-PSSession, Connect-PSSessionили Receive-PSSession для отключения или повторного подключения к интерактивному сеансу.
Чтобы завершить интерактивный сеанс и отключиться от удаленного компьютера, используйте командлет Exit-PSSession или введите exit.
Это важно
Enter-PSSession предназначен для замены текущего интерактивного сеанса новым интерактивным удаленным сеансом. Не следует вызывать его из функции или скрипта или передавать его в виде команды в исполняемый файл powershell.exe.
Примеры
Пример 1. Запуск интерактивного сеанса
PS C:\> Enter-PSSession
[localhost]: PS C:\>Эта команда запускает интерактивный сеанс на локальном компьютере. Командная строка изменяется, чтобы указать, что теперь выполняются команды в другом сеансе.
Команды, которые вы вводите в новом сеансе, и результаты возвращаются в сеанс по умолчанию в виде текста.
Пример 2. Работа с интерактивным сеансом
Первая команда использует командлет Enter-PSSession для запуска интерактивного сеанса с сервером Server01, удаленного компьютера. При запуске сеанса командная строка изменяет имя компьютера.
Вторая команда получает процесс PowerShell и перенаправляет выходные данные в файл Process.txt.
Команда отправляется на удаленный компьютер, а файл сохраняется на удаленном компьютере.
Третья команда использует ключевое слово exit для завершения интерактивного сеанса и закрытия соединения.
Четвертая команда подтверждает, что файл Process.txt находится на удаленном компьютере. Команда Get-ChildItem ("dir") на локальном компьютере не может найти файл.
PS C:\> Enter-PSSession -ComputerName Server01
[Server01]: PS C:\>
[Server01]: PS C:\> Get-Process powershell > C:\ps-test\Process.txt
[Server01]: PS C:\> exit
PS C:\>
PS C:\> dir C:\ps-test\Process.txt
Get-ChildItem : Cannot find path 'C:\ps-test\Process.txt' because it does not exist.
At line:1 char:4
+ dir <<<< C:\ps-test\Process.txtЭта команда показывает, как работать в интерактивном сеансе с удаленным компьютером.
Пример 3. Использование параметра сеанса
PS> $s = New-PSSession -ComputerName Server01
PS> Enter-PSSession -Session $s
[Server01]: PS>Эти команды используют параметр сеансаEnter-PSSession для запуска интерактивного сеанса в существующем сеансе PowerShell (PSSession).
Пример 4. Запуск интерактивного сеанса и указание параметров порта и учетных данных
PS> Enter-PSSession -ComputerName Server01 -Port 90 -Credential Domain01\User01
[Server01]: PS>Эта команда запускает интерактивный сеанс с компьютером Server01. Он использует параметр порта для указания порта и параметра учетных данных, чтобы указать учетную запись пользователя, имеющего разрешение на подключение к удаленному компьютеру.
Пример 5. Остановка интерактивного сеанса
PS> Enter-PSSession -ComputerName Server01
[Server01]: PS> Exit-PSSession
PS>В этом примере показано, как запустить и остановить интерактивный сеанс. Первая команда использует командлет Enter-PSSession для запуска интерактивного сеанса с компьютером Server01.
Вторая команда использует командлет Exit-PSSession для завершения сеанса. Вы также можете использовать ключевое слово exit для завершения интерактивного сеанса.
Exit-PSSession и exit имеют одинаковый эффект.
Параметры
-AllowRedirection
Разрешает перенаправление данного соединения на альтернативный URI. По умолчанию перенаправление запрещено.
При использовании параметра ConnectionURI удаленный целевой объект может вернуть инструкцию для перенаправления в другой универсальный код ресурса (URI). По умолчанию PowerShell не перенаправляет подключения, но этот параметр можно использовать для перенаправления подключения.
Можно также ограничить количество перенаправлений подключения, изменив значение параметра MaximumConnectionRedirectionCount в сеансе. Используйте параметр MaximumRedirection командлета New-PSSessionOption или задайте свойство MaximumConnectionRedirectionCount переменной настроек $PSSessionOption. Значение по умолчанию — 5.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ApplicationName
Определяет сегмент имени приложения в URI соединения. Этот параметр позволяет указать имя приложения, если в команде не используется параметр ConnectionURI.
Значение по умолчанию — это значение переменной $PSSessionApplicationName предпочтения на локальном компьютере. Если привилегированная переменная не определена, значение по умолчанию — WSMAN. Это значение подходит для большинства случаев Дополнительные сведения см. в разделе about_Preference_Variables.
Служба WinRM использует имя приложения для выбора прослушивателя для обслуживания запроса на подключение. Значение этого параметра должно совпадать со значением свойства URLPrefix прослушивателя на удаленном компьютере.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Authentication
Указывает механизм, используемый для проверки подлинности учетных данных пользователя. Допустимые значения для этого параметра:
- По умолчанию
- Базовый
- Credssp
- дайджест
- Kerberos
- Вести переговоры
- NegotiateWithImplicitCredential
Значение по умолчанию — Default.
Проверка подлинности CredSSP доступна только в Windows Vista, Windows Server 2008 и более поздних версиях операционной системы Windows.
Дополнительные сведения о значениях этого параметра см. в разделе AuthenticationMechanism Enum.
Осторожность
Проверка подлинности поставщика поддержки безопасности учетных данных (CredSSP), при которой учетные данные пользователя передаются на удалённый компьютер для прохождения проверки подлинности, предназначена для команд, требующих аутентификации на нескольких источниках, таких как доступ к удалённому сетевому ресурсу. Этот механизм повышает риск безопасности удаленной операции. Если удаленный компьютер скомпрометирован, учетные данные, передаваемые ему, можно использовать для управления сетевым сеансом.
| Тип: | AuthenticationMechanism |
| Допустимые значения: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CertificateThumbprint
Указывает сертификат цифрового открытого ключа (X509) учетной записи пользователя, которая имеет разрешение на выполнение этого действия. Введите отпечаток пальца сертификата.
Сертификаты используются в аутентификации, основанной на клиентских сертификатах. Их можно сопоставить только с локальными учетными записями пользователей; Они не работают с учетными записями домена.
Чтобы получить сертификат, используйте команду Get-Item или Get-ChildItem на диске PowerShell Cert.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ComputerName
Указывает имя компьютера. Этот командлет запускает интерактивный сеанс с указанным удаленным компьютером. Введите только одно имя компьютера. По умолчанию используется локальный компьютер.
Введите имя NetBIOS, IP-адрес или полное доменное имя компьютера. Вы также можете передать имя компьютера в Enter-PSSession.
Чтобы использовать IP-адрес в значении параметра ComputerName, команда должна включать параметр Credential. Кроме того, компьютер должен быть настроен для транспорта HTTPS или IP-адрес удаленного компьютера должен быть включен в список TrustedHosts службы WinRM на локальном компьютере. Инструкции по добавлению имени компьютера в список TrustedHosts см. в разделе "Добавление компьютера в список доверенных узлов" в about_Remote_Troubleshooting.
Примечание.
Чтобы включить локальный компьютер в значение параметра ComputerName, необходимо запустить PowerShell с параметром "Запуск от имени администратора".
| Тип: | String |
| Aliases: | Cn |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ConfigurationName
Указывает конфигурацию сеанса, используемую для интерактивного сеанса.
Введите имя конфигурации или полный URI ресурса для конфигурации сеанса. Если указать только имя конфигурации, предопределен следующий URI схемы: http://schemas.microsoft.com/powershell.
Конфигурация сеанса для сеанса размещается на удаленном компьютере. Если указанная конфигурация сеанса не существует на удаленном компьютере, команда завершается ошибкой.
Значение по умолчанию — это значение переменной $PSSessionConfigurationName предпочтения на локальном компьютере. Если эта переменная предпочтения не задана, по умолчанию используется Microsoft.PowerShell. Дополнительные сведения см. в разделе about_Preference_Variables.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ConnectionUri
Задает универсальный код ресурса (URI), определяющий конечную точку подключения для сеанса. Универсальный код ресурса (URI) должен быть полностью определённым. Формат этой строки выглядит следующим образом:
<Transport>://<ComputerName>:<Port>/<ApplicationName>
Значение по умолчанию выглядит следующим образом:
http://localhost:5985/WSMAN
Если не указать ConnectionURI, можно использовать параметры UseSSL, ComputerName, порти параметры applicationName ApplicationName для указания значений connectionURI.
Допустимые значения для сегмента транспорта URI: HTTP и HTTPS. Если указать URI подключения с сегментом транспорта, но не указать порт, сеанс создается с помощью портов стандартов: 80 для HTTP и 443 для HTTPS. Чтобы использовать порты по умолчанию для удаленного взаимодействия PowerShell, укажите порт 5985 для HTTP или 5986 для HTTPS.
Если целевой компьютер перенаправляет подключение к другому URI, PowerShell запрещает перенаправление, если в команде не используется параметр AllowRedirection.
| Тип: | Uri |
| Aliases: | URI, CU |
| Position: | 1 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ContainerId
Указывает идентификатор контейнера.
| Тип: | String |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Credential
Указывает учетную запись пользователя, которая имеет разрешение на выполнение этого действия. По умолчанию используется текущий пользователь.
Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential, созданный командлетом Get-Credential. Если ввести имя пользователя, вам будет предложено ввести пароль.
Учетные данные хранятся в объекте PSCredential, а пароль хранится в виде SecureString.
Примечание.
Дополнительные сведения о защите данных SecureString см. в разделе Как безопасно SecureString?.
| Тип: | PSCredential |
| Position: | 1 |
| Default value: | Current user |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-EnableNetworkAccess
Указывает, что этот командлет добавляет интерактивный маркер безопасности в сеансы обратного цикла. Интерактивный маркер позволяет выполнять в петлевом сеансе команды, которые получают данные с других компьютеров. Например, можно выполнить команду в сеансе, который копирует XML-файлы с удаленного компьютера на локальный.
Сеанс обратного цикла — это сеанс PSSession , который возникает и заканчивается на том же компьютере. Чтобы создать сеанс обратного цикла, опустите параметр ComputerName или задайте для нее значение. (dot), localhost или имя локального компьютера.
По умолчанию сеансы обратного цикла создаются с помощью сетевого маркера, который может не предоставить достаточно разрешений для проверки подлинности на удаленных компьютерах.
Параметр EnableNetworkAccess действует только в петлевых сеансах. Если при создании сеанса на удаленном компьютере используется EnableNetworkAccess , команда завершается успешно, но параметр игнорируется.
Вы также можете разрешить удаленный доступ в сеансе обратного цикла с помощью значения CredSSP параметра проверки подлинности, который делегирует учетные данные сеанса другим компьютерам.
Этот параметр появился в Windows PowerShell 3.0.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Id
Указывает идентификатор существующего сеанса.
Enter-PSSession использует указанный сеанс для интерактивного сеанса.
Чтобы найти идентификатор сеанса, используйте командлет Get-PSSession.
| Тип: | Int32 |
| Position: | 0 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-InstanceId
Указывает идентификатор экземпляра существующего сеанса.
Enter-PSSession использует указанный сеанс для интерактивного сеанса.
Идентификатор экземпляра — это GUID. Чтобы найти идентификатор экземпляра сеанса, используйте командлет Get-PSSession. Можно также использовать параметры сеанса, имениили идентификатора для указания существующего сеанса. Также можно использовать параметр ComputerName для запуска временного сеанса.
| Тип: | Guid |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Name
Указывает понятное имя существующего сеанса.
Enter-PSSession использует указанный сеанс для интерактивного сеанса.
Если указанное имя соответствует нескольким сеансам, команда завершается ошибкой. Вы также можете использовать параметры сеанса, InstanceIdили идентификатора для указания существующего сеанса. Также можно использовать параметр ComputerName для запуска временного сеанса.
Чтобы установить понятное имя сеанса, используйте параметр Name командлета New-PSSession.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Port
Указывает сетевой порт на удаленном компьютере, который используется для этой команды. Чтобы подключиться к удаленному компьютеру, удаленный компьютер должен прослушивать порт, используемый подключением. Порты по умолчанию — 5985, который является портом WinRM для HTTP и 5986, который является портом WinRM для HTTPS.
Перед использованием альтернативного порта необходимо настроить прослушиватель WinRM на удаленном компьютере, чтобы прослушивать этот порт. Чтобы настроить прослушиватель, используйте следующие команды:
winrm delete winrm/config/listener?Address=*+Transport=HTTPwinrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}
Не используйте параметр Port , если только не требуется. Параметр порта в команде применяется ко всем компьютерам или сеансам, на которых выполняется команда. Альтернативный параметр порта может предотвратить выполнение команды на всех компьютерах.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RunAsAdministrator
Указывает, что PSSession выполняется от имени администратора.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Session
Указывает сеанс PowerShell (PSSession) для интерактивного сеанса. Этот параметр принимает объект сеанса. Можно также использовать параметры name, InstanceIdили id, чтобы указать PSSession.
Введите переменную, содержащую объект сеанса или команду, которая создает или получает объект сеанса, например команду New-PSSession или Get-PSSession. Можно также передать объект сеанса в Enter-PSSession. С помощью этого параметра можно отправить только один PSSession. Если ввести переменную, содержащую несколько PSSession, команда завершается ошибкой.
При использовании Exit-PSSession или ключевого слова exit интерактивный сеанс заканчивается, но созданный PSSession остается открытым и доступным для использования.
| Тип: | PSSession |
| Position: | 0 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-SessionOption
Задает дополнительные параметры сеанса. Введите объект SessionOption, например объект, создаваемый с помощью командлета New-PSSessionOption, или хэш-таблицу, в которой ключи являются именами вариантов сеанса, а значения — значениями параметров сеанса.
Значения по умолчанию для параметров определяются значением переменной предпочтения $PSSessionOption, если она задана. В противном случае значения по умолчанию устанавливаются параметрами, заданными в конфигурации сеанса.
Значения параметра сеанса имеют приоритет над значениями по умолчанию для сеансов, заданных в переменной предпочтения $PSSessionOption и в конфигурации сеанса. Однако они не имеют приоритета над максимальными значениями, квотами или ограничениями, установленными в конфигурации сеанса.
Описание параметров сеанса, включая значения по умолчанию, см. в New-PSSessionOption.
Сведения о переменной предпочтения $PSSessionOption см. в about_Preference_Variables. Дополнительные сведения о конфигурациях сеансов см. в about_Session_Configurations.
| Тип: | PSSessionOption |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-UseSSL
Указывает, что этот командлет использует протокол SSL для установления подключения к удаленному компьютеру. По умолчанию SSL не используется.
WS-Management шифрует все содержимое PowerShell, передаваемое по сети. Параметр UseSSL — это дополнительная защита, которая отправляет данные через HTTPS-подключение вместо HTTP-подключения.
Если вы используете этот параметр, но SSL недоступен на порту, который используется для команды, команда завершается ошибкой.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-VMId
Указывает идентификатор виртуальной машины.
| Тип: | Guid |
| Aliases: | VMGuid |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-VMName
Указывает имя виртуальной машины.
| Тип: | String |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
Входные данные
Вы можете передать имя компьютера в виде строки в этот командлет.
Объект сеанса можно передать в этот командлет.
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
Windows PowerShell включает следующие псевдонимы для Enter-PSSession:
etsn
Чтобы подключиться к удаленному компьютеру, необходимо быть членом группы "Администраторы" на удаленном компьютере. Чтобы запустить интерактивный сеанс на локальном компьютере, необходимо запустить PowerShell с параметром запуска от имени администратора.
При использовании Enter-PSSessionпрофиль пользователя на удаленном компьютере используется для интерактивного сеанса. Команды в профиле удаленного пользователя, включая команды для добавления модулей PowerShell и изменения командной строки, запускаются перед отображением удаленной строки.
Enter-PSSession использует параметр языка и региональных параметров пользовательского интерфейса на локальном компьютере для интерактивного сеанса. Чтобы найти язык и региональные параметры локального пользовательского интерфейса, используйте $UICulture автоматическую переменную.
Enter-PSSession требуются командлеты Get-Command, Out-Defaultи Exit-PSSession. Если эти командлеты не включены в конфигурацию сеанса на удаленном компьютере, команда Enter-PSSession завершается ошибкой.
В отличие от Invoke-Command, который анализирует и интерпретирует команды перед их отправкой на удаленный компьютер, Enter-PSSession отправляет команды непосредственно на удаленный компьютер без интерпретации.
Если сеанс, который вы хотите ввести, занят обработкой команды, может возникнуть задержка, прежде чем PowerShell отвечает на команду Enter-PSSession. Вы подключены сразу после того, как сеанс будет доступен. Чтобы отменить команду Enter-PSSession, нажмите клавиши CTRL +Cклавиши CTRL.
Связанные ссылки
PowerShell