New-PSSession
Создает постоянное подключение к локальному или удаленному компьютеру.
New-PSSession
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ConfigurationName <String>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-ThrottleLimit <Int32>]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
New-PSSession
[-Credential <PSCredential>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ConfigurationName <String>]
[-ThrottleLimit <Int32>]
[-ConnectionUri] <Uri[]>
[-AllowRedirection]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
New-PSSession
-Credential <PSCredential>
[-Name <String[]>]
[-ConfigurationName <String>]
[-VMId] <Guid[]>
[-ThrottleLimit <Int32>]
[<CommonParameters>]
New-PSSession
-Credential <PSCredential>
[-Name <String[]>]
[-ConfigurationName <String>]
-VMName <String[]>
[-ThrottleLimit <Int32>]
[<CommonParameters>]
New-PSSession
[[-Session] <PSSession[]>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ThrottleLimit <Int32>]
[<CommonParameters>]
New-PSSession
[-Name <String[]>]
[-ConfigurationName <String>]
-ContainerId <String[]>
[-RunAsAdministrator]
[-ThrottleLimit <Int32>]
[<CommonParameters>]
New-PSSession
[-Name <String[]>]
[-UseWindowsPowerShell]
[<CommonParameters>]
New-PSSession
[-Name <String[]>]
[-Port <Int32>]
[-HostName] <String[]>
[-UserName <String>]
[-KeyFilePath <String>]
[-Subsystem <String>]
[-ConnectingTimeout <Int32>]
[-SSHTransport]
[-Options <Hashtable>]
[<CommonParameters>]
New-PSSession
[-Name <String[]>]
-SSHConnection <Hashtable[]>
[<CommonParameters>]
Командлет New-PSSession
создает сеанс PowerShell (PSSession) на локальном или удаленном компьютере. При создании PSSession PowerShell устанавливает постоянное подключение к удаленному компьютеру.
Используйте PSSession для выполнения нескольких команд, которые совместно используют данные, например функцию или значение переменной. Чтобы выполнить команды в PSSession, используйте Invoke-Command
командлет. Чтобы использовать PSSession для взаимодействия непосредственно с удаленным компьютером, используйте Enter-PSSession
командлет. Дополнительные сведения см. в about_PSSessions.
Команды можно выполнять на удаленном компьютере, не создавая PSSession с параметрами Enter-PSSession
ComputerName илиInvoke-Command
. При использовании параметра ComputerName PowerShell создает временное соединение, которое используется для команды и затем закрывается.
Начиная с PowerShell 6.0 можно использовать Secure Shell (SSH) для установления подключения и создания сеанса на удаленном компьютере, если SSH доступен на локальном компьютере, а удаленный компьютер настроен с конечной точкой PowerShell SSH. Преимущество удаленного сеанса PowerShell на основе SSH заключается в том, что он может работать на нескольких платформах (Windows, Linux, macOS). Для сеансов на основе SSH используется параметр HostName или SSHConnection , чтобы указать удаленный компьютер и соответствующие сведения о подключении. Дополнительные сведения о настройке удаленного взаимодействия PowerShell SSH см. в статье о удаленном взаимодействии PowerShell по протоколу SSH.
Ескерім
При использовании удаленного взаимодействия WSMan из клиента Linux или macOS с конечной точкой HTTPS, в которой сертификат сервера не является доверенным (например, самозаверяющий сертификат). Необходимо предоставить PSSessionOption, включающее значения SkipCACheck и SkipCNCheck, чтобы $true
успешно установить подключение. Это можно сделать, только если вы находитесь в среде, где вы можете быть уверены в сертификате сервера и сетевом подключении к целевой системе.
$s = New-PSSession
Эта команда создает новую psSession на локальном компьютере и сохраняет PSSession в переменной$s
.
Теперь этот PSSession можно использовать для выполнения команд на локальном компьютере.
$Server01 = New-PSSession -ComputerName Server01
Эта команда создает новую psSession на компьютере Server01 и сохраняет ее в переменной $Server01
.
При создании нескольких объектов PSSession назначьте их переменным с полезными именами. Это поможет вам управлять объектами PSSession в последующих командах.
$s1, $s2, $s3 = New-PSSession -ComputerName Server01,Server02,Server03
Эта команда создает три объекта PSSession , по одному на каждом из компьютеров, указанных параметром ComputerName .
Команда использует оператор назначения (=
) для назначения новых объектов PSSession переменным: $s1
, , $s2
$s3
. Он назначает серверу 01 PSSession , серверу 02 PSSession $s2
$s1
и серверу 03 PSSession . $s3
При назначении нескольких объектов в ряд переменных PowerShell назначает каждому объекту переменную в ряде соответственно. Если объектов больше, чем переменных, все оставшиеся объекты назначаются последней переменной. Если есть больше переменных, чем объекты, остальные переменные пусты ($null
).
New-PSSession -ComputerName Server01 -Port 8081 -UseSSL -ConfigurationName E12
Эта команда создает новую службу PSSession на компьютере Server01, который подключается к порту 8081
сервера и использует протокол SSL. Новая конфигурация PSSession использует альтернативную конфигурацию E12
сеанса.
Прежде чем задать порт, необходимо настроить прослушиватель службы удаленного управления Windows для прослушивания порта 8081 на удаленном компьютере. Дополнительные сведения см. в описании параметра Port.
New-PSSession -Session $s -Credential Domain01\User01
Эта команда создает PSSession с теми же свойствами, что и существующее PSSession. Этот формат команды можно использовать, если ресурсы существующей службы PSSession исчерпаны, а для разгрузки некоторых требований требуется новая служба PSSession.
Команда использует параметр сеанса New-PSSession
для указания psSession , сохраненного в переменной $s
. Он использует учетные данные Domain1\Admin01
пользователя для выполнения команды.
$global:s = New-PSSession -ComputerName Server1.Domain44.Corpnet.Fabrikam.com -Credential Domain01\Admin01
В этом примере показано, как создать PSSession с глобальной областью на компьютере в другом домене.
По умолчанию объекты PSSession, созданные в командной строке, создаются с локальной областью и объектами PSSession, созданными в скрипте, имеют область скрипта.
Чтобы создать PSSession с глобальной областью, создайте новую среду PSSession, а затем сохраните PSSession в переменной, приведение к глобальной области. В этом случае $s
переменная приводится к глобальной области.
Команда использует параметр ComputerName, чтобы указать удаленный компьютер. Так как компьютер находится в домене, отличном от учетной записи пользователя, полное имя компьютера указывается вместе с учетными данными пользователя.
$rs = Get-Content C:\Test\Servers.txt | New-PSSession -ThrottleLimit 50
Эта команда создает PSSession на каждом из 200 компьютеров, перечисленных в Servers.txt
файле, и сохраняет результирующий psSession в переменной$rs
. Объекты PSSession имеют ограничение 50
регулирования.
Этот формат команды можно использовать, если имена компьютеров хранятся в базе данных, электронной таблице, текстовом файле или другом формате, преобразуемом в текст.
$s = New-PSSession -URI http://Server01:91/NewSession -Credential Domain01\User01
Эта команда создает PSSession на компьютере Server01 и сохраняет его в переменной $s
. Он использует параметр URI для указания транспортного протокола, удаленного компьютера, порта и альтернативной конфигурации сеанса. Он также использует параметр Credential для указания учетной записи пользователя, которая имеет разрешение на создание сеанса на удаленном компьютере.
$s = New-PSSession -ComputerName (Get-Content Servers.txt) -Credential Domain01\Admin01 -ThrottleLimit 16
Invoke-Command -Session $s -ScriptBlock {Get-Process PowerShell} -AsJob
Эти команды создают набор объектов PSSession , а затем выполняют фоновое задание в каждом из объектов PSSession .
Первая команда создает новую psSession на каждом из компьютеров, перечисленных в Servers.txt
файле. Он использует New-PSSession
командлет для создания PSSession. Значение параметра ComputerName — это команда, которая использует Get-Content
командлет для получения списка имен Servers.txt
компьютера файла.
Команда использует параметр Credential для создания объектов PSSession , имеющих разрешение администратора домена, и использует параметр ThrottleLimit для ограничения команды на 16
одновременные подключения. Команда сохраняет объекты PSSession в переменной $s
.
Вторая команда использует параметр AsJob командлета для запуска фонового Invoke-Command
задания, выполняющего Get-Process PowerShell
команду в каждом из объектов PSSession в $s
.
Дополнительные сведения о фоновых заданиях PowerShell см. в about_Jobs и about_Remote_Jobs.
New-PSSession -ConnectionURI https://management.exchangelabs.com/Management
Эта команда создает объекты PSSession , которые подключаются к компьютеру, указанному URI вместо имени компьютера.
$so = New-PSSessionOption -SkipCACheck
New-PSSession -ConnectionUri https://management.exchangelabs.com/Management -SessionOption $so -Credential Server01\Admin01
В этом примере показано, как создать объект параметра сеанса и использовать параметр SessionOption.
Первая команда использует New-PSSessionOption
командлет для создания параметра сеанса. Он сохраняет результирующий объект SessionOption в переменной $so
.
Вторая команда использует параметр в новом сеансе. Команда использует New-PSSession
командлет для создания нового сеанса. Значение параметра SessionOption — это объект SessionOption в переменной$so
.
New-PSSession -HostName UserA@LinuxServer01
В этом примере показано, как создать новую PSSession с помощью Secure Shell (SSH). Если SSH настроен на удаленном компьютере для запроса паролей, появится запрос пароля. В противном случае необходимо использовать проверку подлинности пользователя на основе ключа SSH.
New-PSSession -HostName UserA@LinuxServer01:22 -KeyFilePath c:\<path>\userAKey_rsa
В этом примере показано, как создать PSSession с помощью Secure Shell (SSH). Он использует параметр Port для указания порта для использования и параметра KeyFilePath , чтобы указать ключ RSA, используемый для идентификации и проверки подлинности пользователя на удаленном компьютере.
$sshConnections = @(
@{
HostName = 'WinServer1'
UserName = 'domain\userA'
KeyFilePath = 'c:\users\UserA\id_rsa'
}
@{
HostName = 'UserB@LinuxServer5'
KeyFilePath = 'c:\UserB\<path>\id_rsa'
}
)
New-PSSession -SSHConnection $sshConnections
В этом примере показано, как создать несколько сеансов с помощью Secure Shell (SSH) и набора параметров SSHConnection . Параметр SSHConnection принимает массив хэш-таблиц, содержащих сведения о подключении для каждого сеанса. Обратите внимание, что в этом примере требуется, чтобы целевые удаленные компьютеры имели SSH для поддержки проверки подлинности пользователей на основе ключей.
$options = @{
Port=22
User = 'UserB'
Host = 'LinuxServer5'
}
New-PSSession -KeyFilePath '/Users/UserB/id_rsa' -Options $options
В этом примере показано, как создать новый сеанс на основе SSH удаленного компьютера под управлением Linux с помощью параметров SSH. Параметр Options принимает хэш-список значений, передаваемых в качестве параметров базовой ssh
команде, установленной подключением к удаленной системе.
Указывает, что этот командлет разрешает перенаправление этого подключения к альтернативному универсальному идентификатору ресурса (URI).
При использовании параметра ConnectionURI удаленный компьютер может вернуть инструкцию для перенаправления на другой URI. По умолчанию PowerShell не перенаправляет подключения, но этот параметр можно использовать для перенаправления подключения.
Можно также ограничить количество перенаправлений соединения, изменив значение параметра сеанса MaximumConnectionRedirectionCount. Используйте параметр MaximumRedirection командлета New-PSSessionOption
или задайте свойство MaximumConnectionRedirectionCount переменной предпочтения $PSSessionOption. Значение по умолчанию — 5
.
Тип: | SwitchParameter |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Определяет сегмент имени приложения в URI соединения. Этот параметр позволяет указать имя приложения, если в команде не используется параметр ConnectionURI.
Значение по умолчанию — это значение переменной $PSSessionApplicationName
предпочтения на локальном компьютере. Если эта переменная предпочтения не определена, значение по умолчанию равно WSMAN
. Это значение подходит для большинства случаев Дополнительные сведения см. в about_Preference_Variables.
Служба удаленного управления Windows (WinRM) использует имя приложения для выбора прослушивателя для обслуживания запроса на подключение. Значение этого параметра должно совпадать со значением свойства URLPrefix прослушивателя на удаленном компьютере.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Задает механизм, используемый при проверке подлинности учетных данных пользователя. Допустимые значения для этого параметра:
Default
Basic
Credssp
Digest
Kerberos
Negotiate
NegotiateWithImplicitCredential
Значение по умолчанию — Default
.
Дополнительные сведения о значениях этого параметра см. в разделе "Перечисление AuthenticationMechanism".
Назар аударыңыз!
Проверка подлинности поставщика поддержки безопасности учетных данных (CredSSP), в которой учетные данные пользователя передаются на удаленный компьютер для проверки подлинности, предназначена для команд, требующих проверки подлинности на нескольких ресурсах, таких как доступ к удаленному сетевому ресурсу. Этот механизм повышает риск безопасности удаленной операции. Если удаленный компьютер скомпрометирован, учетные данные, передаваемые ему, могут использоваться для управления сетевым сеансом.
Тип: | AuthenticationMechanism |
Допустимые значения: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Задает цифровой сертификат с открытым ключом (X509) учетной записи пользователя, который располагает разрешением для выполнения этого действия. Введите отпечаток сертификата.
Сертификаты используются при проверке подлинности на основе сертификата клиента. Они могут сопоставляться только с учетными записями локальных пользователей и не работают с учетными записями доменов.
Чтобы получить сертификат, используйте Get-Item
или Get-ChildItem
команду на диске PowerShell Cert:
.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Задает массив имен компьютеров. Этот командлет создает постоянное подключение (PSSession) к указанному компьютеру. При вводе нескольких имен компьютеров New-PSSession
создается несколько объектов PSSession , по одному для каждого компьютера. По умолчанию используется локальный компьютер.
Введите имя NetBIOS, IP-адрес или полное доменное имя одного или нескольких удаленных компьютеров. Чтобы указать локальный компьютер, введите имя localhost
компьютера или точку (.
). Если компьютер находится в другом домене, отличном от домена пользователя, полное доменное имя является обязательным.
Вы также можете передать имя компьютера в кавычки New-PSSession
.
Чтобы использовать IP-адрес в значении параметра ComputerName , команда должна включать параметр Credential . Кроме того, компьютер должен быть настроен для транспорта HTTPS или IP-адрес удаленного компьютера должен быть включен в список TrustedHosts службы WinRM на локальном компьютере. Инструкции по добавлению имени компьютера в список TrustedHosts см. в разделе "Добавление компьютера в список доверенных узлов" в about_Remote_Troubleshooting.
Чтобы включить локальный компьютер в значение параметра ComputerName , запустите Windows PowerShell с помощью параметра запуска от имени администратора.
Тип: | String[] |
Aliases: | Cn |
Position: | 0 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Указывает конфигурацию сеанса, используемую для нового psSession.
Введите имя конфигурации или полное имя ресурса (URI) для конфигурации сеанса. Если указать только имя конфигурации, предопределен следующий универсальный код ресурса (URI) схемы: http://schemas.microsoft.com/PowerShell
Конфигурация сеанса для сеанса размещается на удаленном компьютере. Если указанной конфигурации сеанса нет на удаленном компьютере, команда завершается ошибкой.
Значение по умолчанию — это значение переменной $PSSessionConfigurationName
предпочтения на локальном компьютере. Если эта переменная предпочтения не задана, используется Microsoft.PowerShell
значение по умолчанию. Дополнительные сведения см. в about_Preference_Variables.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Указывает время в миллисекундах, разрешенное для завершения начального подключения SSH. Если подключение не завершено в течение указанного времени, возвращается ошибка.
Этот параметр появился в PowerShell 7.2
Тип: | Int32 |
Position: | Named |
Default value: | unlimited |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Задает универсальный код ресурса (URI), определяющий конечную точку подключения для сеанса. Значение URI должно быть указано полностью. Строка имеет следующий формат:
<Transport>://<ComputerName>:<Port>/<ApplicationName>
Значение по умолчанию определяется следующим образом.
http://localhost:5985/WSMAN
Если не указать параметр ConnectionURI, можно использовать параметры UseSSL, ComputerName, Port и ApplicationName для указания значения ConnectionURI.
Допустимые значения для сегмента транспорта URI — HTTP и HTTPS. Если указать универсальный код ресурса (URI) подключения с сегментом транспорта, но не указать порт, сеанс создается с помощью портов стандартов: 80
для HTTP и 443
HTTPS. Чтобы использовать порты по умолчанию для удаленного взаимодействия PowerShell, укажите порт 5985
для HTTP или 5986
HTTPS.
Если целевой компьютер перенаправляет подключение к другому URI, PowerShell запрещает перенаправление, если в команде не используется параметр AllowRedirection .
Тип: | Uri[] |
Aliases: | URI, CU |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Задает массив идентификаторов контейнеров. Этот командлет запускает интерактивный сеанс с каждым из указанных контейнеров. docker ps
Используйте команду, чтобы получить список идентификаторов контейнеров. Дополнительные сведения см. в справке для команды docker ps .
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Указывает учетную запись пользователя, которая имеет разрешение на выполнение этого действия. По умолчанию используется текущий пользователь.
Введите имя пользователя, например User01
или Domain01\User01
или введите объект PSCredential , созданный командлетом Get-Credential
. Если ввести имя пользователя, вам будет предложено ввести пароль.
Учетные данные хранятся в объекте PSCredential , а пароль хранится как SecureString.
Ескерім
Дополнительные сведения о защите данных SecureString см. в разделе "Как безопасна Защита SecureString?".
Тип: | PSCredential |
Position: | Named |
Default value: | Current user |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Указывает, что этот командлет добавляет интерактивный маркер безопасности в сеансы обратного цикла. Интерактивный маркер позволяет выполнять в петлевом сеансе команды, которые получают данные с других компьютеров. Например, можно выполнить команду в сеансе, который копирует XML-файлы с удаленного компьютера на локальный.
Сеанс обратного цикла — это сеанс PSSession , который возникает и заканчивается на том же компьютере. Чтобы создать сеанс обратного цикла, опустите параметр ComputerName или задайте для нее значение dot (.
), localhost
или имя локального компьютера.
По умолчанию этот командлет создает сеансы обратного цикла с помощью сетевого маркера, который может не предоставить достаточно разрешений для проверки подлинности на удаленных компьютерах.
Параметр EnableNetworkAccess действует только в петлевых сеансах. Если при создании сеанса на удаленном компьютере используется EnableNetworkAccess , команда завершается успешно, но параметр игнорируется.
Вы также можете включить удаленный доступ в сеансе обратного цикла с помощью CredSSP
значения параметра проверки подлинности, который делегирует учетные данные сеанса другим компьютерам.
Чтобы защитить компьютер от вредоносного доступа, отключенные сеансы цикла с интерактивными маркерами, созданными с помощью параметра EnableNetworkAccess , можно повторно подключиться только с компьютера, на котором был создан сеанс. Отключенные сеансы, использующие проверку подлинности CredSSP, можно повторно подключить с других компьютеров. Дополнительные сведения см. в разделе Disconnect-PSSession
.
Этот параметр появился в PowerShell 3.0.
Тип: | SwitchParameter |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Задает массив имен компьютеров для подключения на основе Secure Shell (SSH). Это аналогично параметру ComputerName , за исключением того, что подключение к удаленному компьютеру выполняется с помощью SSH, а не Windows WinRM.
Этот параметр появился в PowerShell 6.0.
Тип: | String[] |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Указывает путь к файлу ключа, используемый Secure Shell (SSH) для проверки подлинности пользователя на удаленном компьютере.
SSH позволяет выполнять проверку подлинности пользователей с помощью закрытых и открытых ключей в качестве альтернативы базовой проверке подлинности паролей. Если удаленный компьютер настроен для проверки подлинности ключа, этот параметр можно использовать для предоставления ключа, определяющего пользователя.
Этот параметр появился в PowerShell 6.0.
Тип: | String |
Aliases: | IdentityFilePath |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Указывает понятное имя для PSSession.
Имя можно использовать для ссылки на PSSession при использовании других командлетов, таких как Get-PSSession
и Enter-PSSession
. Имя не обязательно должно быть уникальным для компьютера или текущего сеанса.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Указывает хэш-список параметров SSH, используемых при подключении к удаленному сеансу на основе SSH. Возможные параметры — это любые значения, поддерживаемые версией команды SSH на основе Unix.
Все значения, явно переданные параметрами, имеют приоритет над значениями, переданными в хэш-таблицы Options . Например, при использовании параметра Port переопределяется любая Port
пара "ключ-значение", переданная в хэш-файл " Параметры ".
Тип: | Hashtable |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Задает сетевой порт на удаленном компьютере, используемый для данного соединения. Для подключения к удаленному компьютеру требуется, чтобы он прослушивал порт, используемый соединением. Порты по умолчанию — 5985
это порт WinRM для HTTP, который 5986
является портом WinRM для HTTPS.
Перед использованием другого порта необходимо настроить прослушиватель WinRM на удаленном компьютере для прослушивания этого порта. Для настройки прослушивателя используйте следующие команды:
winrm delete winrm/config/listener?Address=*+Transport=HTTP
winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}
Не используйте параметр Port без крайней необходимости. Настройка порта в команде применяется ко всем компьютерам или сеансам, на которых выполняется команда. Альтернативный порт может помешать выполнению команды на всех компьютерах.
Тип: | Int32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Указывает, что PSSession выполняется от имени администратора.
Тип: | SwitchParameter |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Указывает массив объектов PSSession, используемых этим командлетом в качестве модели для новой psSession. Этот параметр создает новые объекты PSSession с теми же свойствами, что и указанные объекты PSSession .
Введите переменную, содержащую объекты PSSession или команду, которая создает или получает объекты PSSession, например New-PSSession
команду или Get-PSSession
команду.
Полученные объекты PSSession имеют то же имя компьютера, имя приложения, URI подключения, порт, имя конфигурации, ограничение регулирования и ssl-значение, что и исходные значения, но имеют другое отображаемое имя, идентификатор и идентификатор экземпляра (GUID).
Тип: | PSSession[] |
Position: | 0 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Задает дополнительные параметры сеанса. Введите объект SessionOption, например создаваемый с помощью командлетаNew-PSSessionOption
, или хэш-таблицу, в которой ключи являются именами параметров сеанса, а значения — значениями параметра сеанса.
Значения по умолчанию для параметров определяются значением переменной $PSSessionOption
предпочтения, если она задана. В противном случае значения по умолчанию задаются параметрами, указанными в конфигурации сеанса.
Значения параметра сеанса имеют приоритет над значениями по умолчанию для сеансов, заданных в переменной $PSSessionOption
предпочтения и в конфигурации сеанса. Однако они не имеют приоритет над максимальными значениями, квотами и ограничениями, заданными в конфигурации сеанса.
Описание параметров сеанса, включающих значения по умолчанию, см. в разделе New-PSSessionOption
. Сведения о переменной $PSSessionOption
предпочтения см. в about_Preference_Variables. Дополнительные сведения о конфигурациях сеансов см. в разделе about_Session_Configurations.
Тип: | PSSessionOption |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Этот параметр принимает массив хэш-таблиц, где каждый хэш-файл содержит один или несколько параметров подключения, необходимых для установления подключения Secure Shell (SSH) (HostName, Port, UserName, KeyFilePath).
Параметры подключения хэш-кода совпадают с параметрами SSHHost .
Параметр SSHConnection полезен для создания нескольких сеансов, в которых для каждого сеанса требуются разные сведения о подключении.
Этот параметр появился в PowerShell 6.0.
Тип: | Hashtable[] |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Указывает, что удаленное подключение установлено с помощью Secure Shell (SSH).
По умолчанию PowerShell использует Windows WinRM для подключения к удаленному компьютеру. Этот коммутатор заставляет PowerShell использовать набор параметров HostName для установки удаленного подключения на основе SSH.
Этот параметр появился в PowerShell 6.0.
Тип: | SwitchParameter |
Допустимые значения: | true |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Задает подсистему SSH, используемую для новой подсистемы PSSession.
Это указывает подсистему, используемую в целевом объекте, как определено в sshd_config
. Подсистема запускает определенную версию PowerShell с предопределенными параметрами. Если указанная подсистема не существует на удаленном компьютере, команда завершается ошибкой.
Если этот параметр не используется, по умолчанию используется подсистема powershell
.
Тип: | String |
Position: | Named |
Default value: | powershell |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Указывает максимальное число одновременных подключений, которые можно установить для запуска этой команды.
Если этот параметр не указан или введите значение 0
(ноль), используется значение 32
по умолчанию.
Предел регулирования применяется только к текущему командлету, а не к сеансу или компьютеру.
Тип: | Int32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Указывает имя пользователя для учетной записи, используемой для создания сеанса на удаленном компьютере. Метод проверки подлинности пользователя зависит от настройки Secure Shell (SSH) на удаленном компьютере.
Если SSH настроен для базовой проверки подлинности паролей, вам будет предложено ввести пароль пользователя.
Если SSH настроен для проверки подлинности пользователя на основе ключей, то путь к файлу ключа можно указать с помощью параметра KeyFilePath , и вам не будет предложено ввести пароль. Обратите внимание, что если файл ключа пользователя клиента находится в известном расположении SSH, параметр KeyFilePath не нужен для проверки подлинности на основе ключей, а проверка подлинности пользователя выполняется автоматически на основе имени пользователя. Дополнительные сведения см. в документации по SSH о проверке подлинности пользователей на основе ключей.
Это не обязательный параметр. Если параметр UserName не указан, для подключения используется текущий вход с именем пользователя.
Этот параметр появился в PowerShell 6.0.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Указывает, что этот командлет использует протокол SSL для установления подключения к удаленному компьютеру. По умолчанию SSL не используется.
WS-Management шифрует все содержимое PowerShell, передаваемое по сети. Параметр UseSSL обеспечивает дополнительную защиту, которая отправляет данные через HTTPS-подключение вместо HTTP-подключения.
Если вы используете этот параметр, но SSL недоступен на порту, который используется для команды, команда завершается ошибкой.
Тип: | SwitchParameter |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Создает удаленное подключение к новому пространству выполнения Windows PowerShell в локальной системе.
Тип: | SwitchParameter |
Position: | Named |
Default value: | False |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Задает массив идентификаторов виртуальных машин. Этот командлет запускает интерактивный сеанс PowerShell Direct с каждой из указанных виртуальных машин. Дополнительные сведения см. в статье "Автоматизация и управление виртуальными машинами" с помощью PowerShell.
Используйте Get-VM
для просмотра виртуальных машин, доступных на узле Hyper-V.
Тип: | Guid[] |
Aliases: | VMGuid |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Указывает массив имен виртуальных машин. Этот командлет запускает интерактивный сеанс PowerShell Direct с каждой из указанных виртуальных машин. Дополнительные сведения см. в статье "Автоматизация и управление виртуальными машинами" с помощью PowerShell.
Используйте Get-VM
для просмотра виртуальных машин, доступных на узле Hyper-V.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Вы можете передать строку в этот командлет.
System.URI
Вы можете передать универсальный код ресурса (URI) в этот командлет.
Объект сеанса можно передать в этот командлет.
PowerShell включает следующие псевдонимы для New-PSSession
:
Для всех платформ.
nsn
Этот командлет использует инфраструктуру удаленного взаимодействия PowerShell. Чтобы использовать этот командлет, локальный компьютер и все удаленные компьютеры должны быть настроены для удаленного взаимодействия PowerShell. Дополнительные сведения см. в about_Remote_Requirements.
Чтобы создать PSSession на локальном компьютере, запустите PowerShell с параметром запуска от имени администратора .
Завершив работу с PSSession, используйте
Remove-PSSession
командлет для удаления PSSession и освобождения его ресурсов.Наборы параметров HostName и SSHConnection были включены начиная с PowerShell 6.0. Они были добавлены для предоставления удаленного взаимодействия PowerShell на основе Secure Shell (SSH). SSH и PowerShell поддерживаются на нескольких платформах (Windows, Linux, macOS) и удаленном взаимодействии PowerShell будут работать над этими платформами, где установлены и настроены SSH PowerShell. Это отличается от предыдущего удаленного взаимодействия только для Windows, основанного на WinRM, и многие из конкретных функций и ограничений WinRM не применяются. Например, квоты на основе WinRM, параметры сеанса, настраиваемая конфигурация конечной точки и функции отключения и повторного подключения не поддерживаются. Дополнительные сведения о настройке удаленного взаимодействия PowerShell SSH см. в статье о удаленном взаимодействии PowerShell по протоколу SSH.
Исполняемый ssh
файл получает данные конфигурации из следующих источников в следующем порядке:
- Параметры командной строки
- файл конфигурации пользователя (~/.ssh/config)
- Файл конфигурации на уровне системы (/etc/ssh/ssh_config)
Следующие параметры командлета сопоставляются с ssh
параметрами и параметрами:
Параметр командлета | Параметр ssh | эквивалентный параметр ssh -o |
---|---|---|
-KeyFilePath |
-i <KeyFilePath> |
-o IdentityFile=<KeyFilePath> |
-UserName |
-l <UserName> |
-o User=<UserName> |
-Port |
-p <Port> |
-o Port=<Port> |
-ComputerName -Subsystem |
-s <ComputerName> <Subsystem> |
-o Host=<ComputerName> |
Все значения, явно переданные параметрами, имеют приоритет над значениями, переданными в хэш-таблицы Options . Дополнительные сведения о файлах см. в ssh_config
разделе ssh_config(5).
PowerShell кері байланысы
PowerShell — бастапқы коды ашық жоба. Пікір қалдыру үшін сілтемені таңдаңыз: