Share via

Exit-PSSession

  • Referência
Módulo:
Microsoft.PowerShell.Core

Encerra uma sessão interativa com um computador remoto.

Syntax

Exit-PSSession []

Description

O Exit-PSSession cmdlet encerra as sessões interativas iniciadas usando o Enter-PSSession cmdlet .

Você também pode usar o exit palavra-chave para encerrar uma sessão interativa. O efeito é o mesmo que usar Exit-PSSession.

Exemplos

Exemplo 1: Iniciar e parar uma sessão interativa

PS> Enter-PSSession -ComputerName Server01
Server01\PS> Exit-PSSession
PS>

Esses comandos iniciam e param uma sessão interativa com o computador remoto Server01.

Exemplo 2: Iniciar e parar uma sessão interativa usando um objeto PSSession

PS> $s = New-PSSession -ComputerName Server01
PS> Enter-PSSession -Session $s
Server01\PS> Exit-PSSession
PS> $s
Id Name            ComputerName    State    ConfigurationName
-- ----            ------------    -----    -----------------
1  Session1        Server01        Opened   Microsoft.PowerShell

Esses comandos iniciam e interrompem uma sessão interativa com o computador Server01 que usa uma sessão do PowerShell (PSSession).

Como a sessão interativa foi iniciada usando uma sessão do PowerShell, a PSSession ainda estará disponível quando a sessão interativa terminar. Se você usar o parâmetro ComputerName , Enter-PSSession criará uma sessão temporária que será fechada quando a sessão interativa terminar.

O primeiro comando usa o New-PSSession cmdlet para criar uma PSSession no computador Server01. O comando salva a PSSession na $s variável .

O segundo comando usa Enter-PSSession para iniciar uma sessão interativa usando a PSSession no $s.

O terceiro comando usa Exit-PSSession para interromper a sessão interativa.

O comando final exibe a PSSession na $s variável . A propriedade State mostra que a PSSession ainda está aberta e disponível para uso.

Exemplo 3: usar o palavra-chave de Saída para interromper uma sessão

PS> Enter-PSSession -ComputerName Server01
Server01\PS> exit
PS>

Este exemplo usa o exit palavra-chave para interromper uma sessão interativa iniciada usando Enter-PSSession. O exit palavra-chave tem o mesmo efeito que usar Exit-PSSession.

Entradas

None

Você não pode canalizar objetos para este cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

O PowerShell inclui os seguintes aliases para Exit-PSSession:

  • Todas as plataformas:
    • exsn

Esse cmdlet usa apenas os parâmetros comuns.