Exit-PSSession

Artigo
10/30/2009

Encerra uma sessão interativa com um computador remoto.

Sintaxe

Exit-PSSession [<CommonParameters>]

Descrição

O cmdlet Exit-PSSession encerra sessões interativas que você iniciou usando Enter-PSSession.

Você também pode usar a palavra-chave Exit para encerrar uma sessão interativa. O efeito é igual ao de usar Exit-PSSession.

Parâmetros

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

Nenhum

Não é possível canalizar objetos para Exit-PSSession.

Saídas

Nenhum

Este cmdlet não retorna nenhuma saída.

Observações

Esse cmdlet assume apenas os parâmetros comuns.

Exemplo 1

C:\PS>Enter-PSSession -computername Server01

Server01\PS> Exit-PSSession

C:\PS>

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

Exemplo 2

C:\PS>$s = new-pssession -computername Server01

C:\PS> Enter-PSSession -session $s

Server01\PS> Exit-PSSession

C:\PS> $s

Id Name            ComputerName    State    ConfigurationName
-- ----            ------------    -----    -----------------
1  Session1        Server01        Opened   Microsoft.PowerShell

Descrição
-----------
Esses comandos iniciam e param uma sessão interativa com o computador Server01 que usa uma sessão do Windows PowerShell (PSSession).

Como a sessão interativa foi iniciada com o uso de uma sessão do Windows PowerShell (PSSession), uma 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 uma PSSession no computador Server01. O comando salva a PSSession na variável $s.

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

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

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

Exemplo 3

C:\PS>Enter-PSSession -computername Server01

Server01\PS> exit

C:\PS>

Descrição
-----------
Esse comando usa a palavra-chave Exit para encerrar uma sessão interativa iniciada com o uso do cmdlet Enter-PSSession. A palavra-chave Exit tem o mesmo efeito que usar Exit-PSSession.

Consulte também

Conceitos

about_PSSessions
about_Remote
Enter-PSSession
New-PSSession
Get-PSSession
Remove-PSSession
Invoke-Command

Compartilhar via