Поделиться через


Get-PSSession

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

Синтаксис

Get-PSSession
   [-Name <String[]>]
   [<CommonParameters>]
Get-PSSession
   [-ComputerName] <String[]>
   [-ApplicationName <String>]
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-Port <Int32>]
   [-UseSSL]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]
Get-PSSession
   [-ComputerName] <String[]>
   [-ApplicationName <String>]
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-Port <Int32>]
   [-UseSSL]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]
Get-PSSession
   [-ConnectionUri] <Uri[]>
   [-ConfigurationName <String>]
   [-AllowRedirection]
   -InstanceId <Guid[]>
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]
Get-PSSession
   [-ConnectionUri] <Uri[]>
   [-ConfigurationName <String>]
   [-AllowRedirection]
   [-Name <String[]>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [-ThrottleLimit <Int32>]
   [-State <SessionFilterState>]
   [-SessionOption <PSSessionOption>]
   [<CommonParameters>]
Get-PSSession
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-State <SessionFilterState>]
   -VMName <String[]>
   [<CommonParameters>]
Get-PSSession
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-State <SessionFilterState>]
   -ContainerId <String[]>
   [<CommonParameters>]
Get-PSSession
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -ContainerId <String[]>
   [<CommonParameters>]
Get-PSSession
   [-ConfigurationName <String>]
   [-Name <String[]>]
   [-State <SessionFilterState>]
   -VMId <Guid[]>
   [<CommonParameters>]
Get-PSSession
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -VMId <Guid[]>
   [<CommonParameters>]
Get-PSSession
   [-ConfigurationName <String>]
   -InstanceId <Guid[]>
   [-State <SessionFilterState>]
   -VMName <String[]>
   [<CommonParameters>]
Get-PSSession
   [-InstanceId <Guid[]>]
   [<CommonParameters>]
Get-PSSession
   [-Id] <Int32[]>
   [<CommonParameters>]

Описание

Командлет Get-PSSession получает управляемые пользователем сеансы PowerShell (PSSessions) на локальных и удаленных компьютерах.

Начиная с Windows PowerShell 3.0 сеансы хранятся на компьютерах в удаленном конце каждого подключения. Параметры ComputerName или ConnectionUri можно использовать для получения сеансов Get-PSSession , которые подключаются к локальному или удаленному компьютеру, даже если они не были созданы в текущем сеансе.

Без параметров получает все сеансы, Get-PSSession созданные в текущем сеансе.

Используйте параметры фильтрации, включая Name, ID, InstanceID, State, ApplicationName и ConfigurationName , чтобы выбрать один из возвращающих Get-PSSession сеансов.

Используйте остальные параметры, чтобы настроить временное подключение, в котором Get-PSSession выполняется команда при использовании параметров ComputerName или ConnectionUri .

Примечание. В Windows PowerShell 2.0 без параметров получает все сеансы, Get-PSSession созданные в текущем сеансе. Параметр ComputerName получает сеансы, созданные в текущем сеансе, и подключается к указанному компьютеру.

Дополнительные сведения о сеансах PowerShell см. в разделе about_PSSessions.

Примеры

Пример 1. Получение сеансов, созданных в текущем сеансе

Get-PSSession

Эта команда получает все сеансы PSSessions , созданные в текущем сеансе. Он не получает сеансы PSSessions , созданные в других сеансах или на других компьютерах, даже если они подключаются к этому компьютеру.

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

Get-PSSession -ComputerName "localhost"

Эта команда возвращает сеансы PSSession , подключенные к локальному компьютеру. Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.)

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

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

Get-PSSession -ComputerName "Server02"

Id Name            ComputerName    State         ConfigurationName     Availability
 -- ----            ------------    -----         -----------------     ------------
  2 Session3        Server02       Disconnected  ITTasks                       Busy
  1 ScheduledJobs   Server02       Opened        Microsoft.PowerShell     Available
  3 Test            Server02       Disconnected  Microsoft.PowerShell          Busy

Эта команда получает сеансы PSSession , подключенные к компьютеру Server02.

Эта команда возвращает все сеансы на компьютере Server02, даже если они были созданы в других сеансах или на других компьютерах.

Выходные данные показывают, что два сеансы находятся в отключенном состоянии с доступностью "Занято". Они были созданы в различных сеансах и в настоящее время используются. Сеанс ScheduledJobs( открытый и доступный) был создан в текущем сеансе.

Пример 4. Сохранение результатов этой команды

New-PSSession -ComputerName Server01, Server02, Server03
$s1, $s2, $s3 = Get-PSSession

В этом примере показано, как сохранить результаты Get-PSSession команды в нескольких переменных.

Первая команда использует New-PSSession командлет для создания сеансов PSSessions на трех удаленных компьютерах.

Вторая команда использует Get-PSSession командлет для получения трех сеансов PSSessions. Затем каждый из сеансов PSSessions сохраняется в отдельной переменной.

Когда PowerShell назначает массив объектов массиву переменных, первый объект назначается первой переменной, второй объект — второй переменной и т. д. Если объектов больше, чем переменных, все оставшиеся объекты назначаются последней переменной в массиве. Если переменных больше, чем объектов, дополнительные переменные не используются.

Пример 5. Удаление сеанса с помощью идентификатора экземпляра

Get-PSSession | Format-Table -Property ComputerName, InstanceID
$s = Get-PSSession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f
Remove-PSSession -Session $s

В этом примере показано, как получить PSSession с помощью идентификатора экземпляра, а затем удалить psSession.

Первая команда получает все сеансы PSSession , созданные в текущем сеансе. Он отправляет psSessions в командлет Format-Table, который отображает свойства ComputerName и InstanceID каждого сеанса PSSession.

Вторая команда использует Get-PSSession командлет для получения определенного сеанса PSSession и сохранения его в переменной $s . Команда использует параметр InstanceID для идентификации PSSession.

Третья команда использует командлет Remove-PSSession для удаления PSSession в переменной $s .

Пример 6. Получение сеанса с определенным именем

Команды в этом примере находят сеанс, имя которого имеет определенный формат, использует конфигурацию сеанса и затем подключается к сеансу. С помощью подобной команды можно найти сеанс, в котором коллега запустил задачу, и подключиться к нему для завершения задачи.

Get-PSSession -ComputerName Server02, Server12 -Name BackupJob* -ConfigurationName ITTasks -SessionOption @{OperationTimeout=240000}

Id Name            ComputerName    State         ConfigurationName     Availability
 -- ----            ------------    -----         -----------------     ------------
  3 BackupJob04     Server02        Disconnected        ITTasks                  None

$s = Get-PSSession -ComputerName Server02 -Name BackupJob04 -ConfigurationName ITTasks | Connect-PSSession
$s

Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
 5 BackupJob04     Server02        Opened        ITTasks                  Available

Первая команда получает сеансы на удаленных компьютерах Server02 и Server12, имена которых начинаются с BackupJob и используют конфигурацию сеанса ITTasks. Команда использует параметр Name для указания шаблона имени и параметр ConfigurationName для указания конфигурации сеанса. Значение параметра SessionOption — это хэш-таблица, которая устанавливает для параметра OperationTimeout значение 240 000 мс (4 минуты). Этот параметр дает команде больше времени на выполнение. Параметры ConfigurationName и SessionOption используются для настройки временных сеансов, в которых Get-PSSession выполняется командлет на каждом компьютере. В выходных данных показано, что команда возвращает сеанс BackupJob04. Сеанс отключен, а для параметра Доступность задано значение Нет, что означает, что он не используется.

Вторая команда использует Get-PSSession командлет для подключения к сеансу BackupJob04 и командлет Connect-PSSession для подключения к сеансу. Сеанс сохраняется в переменную $s.

Третья команда получает сеанс в переменной $s. В выходных данных показано, что Connect-PSSession команда выполнена успешно. Сеанс находится в состоянии Opened и доступен для использования.

Пример 7. Получение сеанса по его идентификатору

Get-PSSession -Id 2

Эта команда возвращает PSSession с идентификатором 2. Так как значение свойства ID уникально только в текущем сеансе, параметр Id допустим только для локальных команд.

Параметры

-AllowRedirection

Указывает, что этот командлет разрешает перенаправление этого подключения на альтернативный универсальный код ресурса (URI). По умолчанию PowerShell не перенаправляет подключения.

Этот параметр настраивает временное подключение, созданное для выполнения команды с параметром Get-PSSessionConnectionUri .

Этот параметр впервые появился в Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationName

Указывает имя приложения. Этот командлет подключается только к сеансам, используюющим указанное приложение.

Введите сегмент имени приложения URI подключения. Например, в следующем URI подключения имя приложения — WSMan: https://localhost:5985/WSMAN. Имя приложения сеанса хранится в свойстве сеанса Runspace.ConnectionInfo.AppName.

Значение этого параметра используется для выбора и фильтрации сеансов. Оно не изменяет приложение, которое использует сеанс.

Type:String
Position:Named
Default value:All sessions
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Authentication

Указывает механизм, используемый для проверки подлинности учетных данных для сеанса, в котором выполняется Get-PSSession команда.

Этот параметр настраивает временное подключение, созданное для выполнения команды с параметром Get-PSSessionComputerName или ConnectionUri .

Допустимые значения для этого параметра:

  • Default
  • Basic
  • Credssp
  • Digest (дайджест)
  • Kerberos
  • Согласование
  • NegotiateWithImplicitCredential.

Значение по умолчанию — Default.

Дополнительные сведения о значениях этого параметра см. в разделе AuthenticationMechanism Enumeration.

ВНИМАНИЕ! Проверка подлинности поставщика поддержки безопасности учетных данных (CredSSP), при которой учетные данные пользователя передаются на удаленный компьютер для проверки подлинности, предназначена для команд, требующих проверки подлинности в нескольких ресурсах, например для доступа к удаленной сетевой папке. Этот механизм повышает риск безопасности удаленной операции. Если удаленный компьютер скомпрометирован, учетные данные, передаваемые ему, могут использоваться для управления сетевым сеансом.

Этот параметр впервые появился в Windows PowerShell 3.0.

Type:AuthenticationMechanism
Accepted values:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Default value:Default
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificateThumbprint

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

Этот параметр настраивает временное подключение, созданное для выполнения команды с параметром Get-PSSessionComputerName или ConnectionUri .

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

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

Этот параметр впервые появился в Windows PowerShell 3.0.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Задает массив имен компьютеров. Возвращает сеансов, которые подключаются к указанным компьютерам. Подстановочные знаки не допускаются. Значение по умолчанию отсутствует.

Начиная с Windows PowerShell 3.0, объекты PSSession хранятся на компьютерах в удаленном конце каждого подключения. Чтобы получить сеансы на указанных компьютерах, PowerShell создает временное подключение к каждому компьютеру Get-PSSession и выполняет команду.

Введите имя NetBIOS, IP-адрес или полное доменное имя одного или нескольких компьютеров. Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.).

Примечание. Этот параметр получает сеансы только с компьютеров под управлением Windows PowerShell 3.0 или более поздних версий PowerShell. Предыдущие версии не хранят сеансы.

Type:String[]
Aliases:Cn
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationName

Указывает имя конфигурации. Этот командлет получает только сеансы, использующие указанную конфигурацию сеанса.

Введите имя конфигурации или полное имя ресурса (URI) для конфигурации сеанса. Если указать только имя конфигурации, в начале добавляется следующий универсальный код ресурса (URI) схемы: https://schemas.microsoft.com/powershell. Имя конфигурации сеанса хранится в свойстве сеанса ConfigurationName.

Значение этого параметра используется для выбора и фильтрации сеансов. Оно не изменяет конфигурацию, которую использует сеанс.

Дополнительные сведения о конфигурациях сеансов см. в разделе about_Session_Configurations.

Type:String
Position:Named
Default value:All sessions
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ConnectionUri

Указывает универсальный код ресурса (URI), определяющий конечную точку подключения для временного сеанса, в котором выполняется Get-PSSession команда. Значение URI должно быть указано полностью.

Этот параметр настраивает временное подключение, созданное для выполнения команды с параметром Get-PSSessionConnectionUri .

Строки имеют следующий формат:

<Transport>://<ComputerName>:<Port\>/<ApplicationName>

Значение по умолчанию ― https://localhost:5985/WSMAN.

Если не указать ConnectionUri, можно использовать параметры UseSSL, ComputerName, Port и ApplicationName , чтобы указать значения ConnectionURI . Допустимые значения для сегмента транспорта URI — HTTP и HTTPS. Если указать URI подключения с сегментом Transport, но не указать порт, сеанс будет создан со стандартными портами: 80 для HTTP и 443 для HTTPS. Чтобы использовать порты по умолчанию для удаленного взаимодействия PowerShell, укажите порт 5985 для HTTP или 5986 для HTTPS.

Если конечный компьютер перенаправляет подключение на другой универсальный код ресурса (URI), PowerShell запрещает перенаправление, если в команде не используется параметр AllowRedirection .

Этот параметр впервые появился в Windows PowerShell 3.0.

Этот параметр получает сеансы только с компьютеров под управлением Windows PowerShell 3.0 или более поздних версий Windows PowerShell. Предыдущие версии не хранят сеансы.

Type:Uri[]
Aliases:URI, CU
Position:0
Default value:Http://localhost:5985/WSMAN
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ContainerId

Указывает массив идентификаторов контейнеров. Этот командлет запускает интерактивный сеанс с каждым из указанных контейнеров. Используйте команду , docker ps чтобы получить список идентификаторов контейнеров. Дополнительные сведения см. в справке по команде Docker ps .

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Указывает учетные данные пользователя. Этот командлет выполняет команду с разрешениями указанного пользователя. Укажите учетную запись пользователя с разрешением на подключение к удаленному компьютеру Get-PSSession и выполните команду. По умолчанию используется текущий пользователь.

Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential , созданный командлетом Get-Credential . Если ввести имя пользователя, вам будет предложено ввести пароль.

Учетные данные хранятся в объекте PSCredential , а пароль хранится как SecureString.

Примечание

Дополнительные сведения о защите данных SecureString см. в разделе Как безопасно secure is SecureString?.

Этот параметр настраивает для временного подключения, созданного для выполнения команды с параметром Get-PSSessionComputerName или ConnectionUri .

Этот параметр впервые появился в Windows PowerShell 3.0.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Указывает массив идентификаторов сеансов. Этот командлет получает только сеансы с указанными идентификаторами. Введите один или несколько идентификаторов, разделенных запятыми, или используйте оператор диапазона (..), чтобы указать диапазон идентификаторов. Нельзя использовать параметр ID вместе с параметром ComputerName .

Идентификатор — это целое число, однозначно определяющее управляемые пользователем сеансы в текущем сеансе. Его легче запомнить и ввести, чем InstanceId, но он уникален только в текущем сеансе. Идентификатор сеанса хранится в свойстве ID сеанса.

Type:Int32[]
Position:0
Default value:All sessions
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstanceId

Задает массив идентификаторов экземпляров сеансов. Этот командлет получает только сеансы с указанными идентификаторами экземпляров.

Идентификатор экземпляра — это GUID, однозначно определяющий сеанс на локальном или удаленном компьютере. Идентификатор экземпляра уникален, даже если в PowerShell выполняется несколько сеансов.

Идентификатор экземпляра сеанса хранится в свойстве сеанса InstanceID.

Type:Guid[]
Position:Named
Default value:All sessions
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Задает массив имен сеансов. Этот командлет получает только сеансы с указанными понятными именами. Можно использовать подстановочные знаки.

Понятное имя сеанса хранится в свойстве Name.

Type:String[]
Position:Named
Default value:All sessions
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Port

Указывает указанный сетевой порт, используемый для временного подключения, в котором выполняется Get-PSSession команда. Для подключения к удаленному компьютеру требуется, чтобы он прослушивал порт, используемый соединением. По умолчанию используются порты 5985, которые являются портом WinRM для HTTP, и 5986, который является портом WinRM для HTTPS.

Прежде чем использовать альтернативный порт, необходимо настроить прослушиватель WinRM на удаленном компьютере для прослушивания по этому порту. Чтобы настроить прослушиватель, введите в командной строке PowerShell следующие две команды:

Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse

New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>

Этот параметр настраивает для временного подключения, созданного для выполнения команды с параметром Get-PSSessionComputerName или ConnectionUri .

Не используйте параметр Port, если этого можно избежать. Порт, заданный в команде , применяется ко всем компьютерам или сеансам, на которых выполняется команда. Альтернативный порт может помешать выполнению команды на всех компьютерах.

Этот параметр впервые появился в Windows PowerShell 3.0.

Type:Int32
Position:Named
Default value:5985, 5986
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SessionOption

Задает дополнительные параметры для сеанса. Введите объект SessionOption, например объект, созданный с помощью командлета New-PSSessionOption, или хэш-таблицу, где ключи — это имена параметров сеанса, а значения — это значения параметров сеанса.

Значения по умолчанию для параметров определяются значением привилегированной переменной $PSSessionOption, если оно задано. В противном случае значения по умолчанию задаются параметрами, указанными в конфигурации сеанса.

Значения параметров сеанса имеют приоритет над значениями по умолчанию, заданными в переменной $PSSessionOption и конфигурации сеанса. Однако они не имеют приоритет над максимальными значениями, квотами и ограничениями, заданными в конфигурации сеанса.

Описание параметров сеанса, включая значения по умолчанию, см. в разделе New-PSSessionOption. Сведения о переменной предпочтения см. в $PSSessionOptionразделе about_Preference_Variables. Дополнительные сведения о конфигурациях сеансов см. в разделе about_Session_Configurations.

Type:PSSessionOption
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-State

Указывает состояние сеанса. Этот командлет получает только сеансы в указанном состоянии. Допустимые значения для этого параметра: All, Opened, Disconnected, Closed и Broken. Значение по умолчанию — All.

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

Состояние сеанса хранится в свойстве State.

Этот параметр впервые появился в Windows PowerShell 3.0.

Type:SessionFilterState
Accepted values:All, Opened, Disconnected, Closed, Broken
Position:Named
Default value:All
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Указывает максимальное количество одновременных подключений, которые можно установить для выполнения Get-PSSession команды. Если этот параметр не указан или введено значение 0 (ноль), используется значение по умолчанию — 32. Предел регулирования применяется только к текущему командлету, а не к сеансу или компьютеру.

Этот параметр впервые появился в Windows PowerShell 3.0.

Type:Int32
Position:Named
Default value:32
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSSL

Указывает, что этот командлет использует протокол SSL для установки соединения, в котором выполняется Get-PSSession команда. По умолчанию SSL не используется. Если вы используете этот параметр, но SSL недоступен для порт, указанному в команде, она завершается ошибкой.

Этот параметр настраивает временное подключение, созданное для выполнения команды с параметром Get-PSSessionComputerName .

Этот параметр впервые появился в Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMId

Указывает массив идентификаторов виртуальных машин. Этот командлет запускает интерактивный сеанс с каждой из указанных виртуальных машин. Чтобы просмотреть доступные виртуальные машины, используйте следующую команду:

Get-VM | Select-Object -Property Name, ID

Type:Guid[]
Aliases:VMGuid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMName

Указывает массив имен виртуальных машин. Этот командлет запускает интерактивный сеанс с каждой из указанных виртуальных машин. Чтобы просмотреть доступные виртуальные машины, используйте Get-VM командлет .

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Входные данные

None

В этот командлет нельзя передать входные данные.

Выходные данные

PSSession

Примечания

  • Этот командлет получает объекты PSSession , управляемые пользователем, например объекты, созданные с помощью командлетов New-PSSession, Enter-PSSessionи Invoke-Command. Он не получает управляемый системой сеанс, созданный при запуске PowerShell.
  • Начиная с Windows PowerShell 3.0, объекты PSSession хранятся на компьютере, который находится на стороне сервера или на принимающей стороне подключения. Чтобы получить сеансы, хранящиеся на локальном или удаленном компьютере, PowerShell устанавливает временный сеанс для указанного компьютера и выполняет команды запроса в сеансе.
  • Чтобы получить сеансы, которые подключены к удаленному компьютеру, укажите удаленный компьютер в параметре ComputerName или ConnectionUri. Чтобы отфильтровать извлекаемые Get-PSSession сеансы, используйте параметры Name, ID, InstanceID и State . Используйте остальные параметры для настройки временного сеанса, который Get-PSSession использует .
  • При использовании параметров ComputerName или ConnectionUri получает только сеансы с компьютеров под Get-PSSession управлением Windows PowerShell 3.0 и более поздних версий PowerShell.
  • Значение свойства StatepsSession относится к текущему сеансу. Таким образом, значение Disconnected означает, что PSSession не подключен к текущему сеансу. Однако это не означает, что PSSession отключен от всех сеансов. Он может быть подключен к другому сеансу. Чтобы определить, можно ли подключиться или повторно подключиться к PSSession из текущего сеанса, используйте свойство Availability .

Если свойство Availability имеет значение None, подключиться к сеансу можно. Значение Busy указывает, что вы не можете подключиться к PSSession , так как оно подключено к другому сеансу.

Дополнительные сведения о значениях свойства State сеансов см. в разделе Перечисление RunspaceState.

Дополнительные сведения о значениях свойства Availability сеансов см. в разделе Перечисление RunspaceAvailability.