Compartilhar via

Exit-PSSession

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

Encerra uma sessão interativa com um computador remoto.

Sintaxe

Exit-PSSession []

Description

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

Você também pode usar a palavra-chave Exit 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 C:\> Enter-PSSession -computername Server01
Server01\PS> Exit-PSSession
PS C:\>

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

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

PS C:\> $Session = New-PSSession -ComputerName Server01
PS C:\> Enter-PSSession -Session $Session
Server01\PS> Exit-PSSession
PS C:\> $Session
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 Windows PowerShell (PSSession).

Como a sessão interativa foi iniciada usando uma sessão do Windows PowerShell, o 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 cmdlet New-PSSession para criar um de PSSession no computador Server01. O comando salva o PSSession na variável $s.

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

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

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

Exemplo 3: Usar a palavra-chave Exit para interromper uma sessão

PS C:\> Enter-PSSession -ComputerName "Server01"
Server01\PS> exit

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

Entradas

None

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

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

  • Esse cmdlet usa apenas os parâmetros comuns.