about_PSSessions
Descrição breve
Descreve as sessões do PowerShell (PSSessions) e explica como estabelecer uma conexão persistente com um computador remoto.
Descrição longa
Para executar comandos do PowerShell em um computador remoto, você pode usar o parâmetro ComputerName de um cmdlet ou criar uma sessão do PowerShell (PSSession) e executar comandos no PSSession.
Quando você cria uma PSSession, o PowerShell estabelece uma conexão persistente com o computador remoto. Use uma PSSession para executar uma série de comandos relacionados em um computador remoto. Os comandos executados na mesma PSSession podem compartilhar dados, como os valores de variáveis, aliases e funções.
Você também pode criar uma PSSession no computador local e executar comandos nele. Uma PSSession local usa a infraestrutura de comunicação remota do PowerShell para criar e manter a PSSession.
A partir do Windows PowerShell 3.0, as PSSessionsions no Windows são independentes das sessões em que são criadas. As PSSessions ativas são mantidas no computador remoto (ou no computador no extremidade remoto ou no "lado do servidor" da conexão). Como resultado, no Windows, você pode se desconectar de uma PSSession em um computador Windows remoto e reconectá-lo posteriormente do mesmo computador ou de um computador Windows diferente.
Este tópico explica como criar, usar, obter e excluir PSSessions. Para obter informações mais avançadas, consulte about_PSSession_Details.
Observação: as PSSessions usam a infraestrutura de comunicação remota do PowerShell. Para usar PSSessions, os computadores locais e remotos devem ser configurados para comunicação remota. Para obter mais informações, consulte about_Remote_Requirements.
No Windows Vista e em versões posteriores do Windows, para criar uma PSSession em um computador local, você deve iniciar o PowerShell com a opção "Executar como administrador".
O que é uma sessão?
Uma sessão é um ambiente no qual o PowerShell é executado.
Sempre que você inicia o PowerShell, uma sessão é criada para você e você pode executar comandos na sessão. Você também pode adicionar itens à sessão, como módulos e snap-ins, e pode criar itens, como variáveis, funções e aliases. Esses itens existem apenas na sessão e são excluídos quando a sessão termina.
Você também pode criar sessões gerenciadas pelo usuário, conhecidas como " sessões do PowerShell" ou "PSSessions", no computador local ou em um computador remoto. Assim como a sessão padrão, você pode executar comandos em uma PSSession e adicionar e criar itens. No entanto, ao contrário da sessão iniciada automaticamente, você pode controlar as PSSessionsions criadas. Você pode obtê-los, criar, configurar e removê-los, desconectá-los e reconectá-los e executar vários comandos na mesma PSSession. A PSSession permanece disponível até que você a exclua ou ela tenha um tempo limite.
Normalmente, você cria uma PSSession para executar uma série de comandos relacionados em um computador remoto. Quando você cria uma PSSession em um computador remoto, o PowerShell estabelece uma conexão persistente com o computador remoto para dar suporte à sessão.
Se você usar o parâmetro ComputerName do Invoke-Command cmdlet ou Enter-PSSession para executar um comando remoto ou para iniciar uma sessão interativa, o PowerShell criará uma sessão temporária no computador remoto e fechará a sessão assim que o comando for concluído ou assim que a sessão interativa terminar. Você não pode controlar essas sessões temporárias e não pode usá-las para mais de um único comando ou uma única sessão interativa.
No PowerShell, a "sessão atual" é a sessão em que você está trabalhando. A "sessão atual" pode se referir a qualquer sessão, incluindo uma sessão temporária ou uma PSSession.
Por que usar uma PSSession?
Use uma PSSession quando precisar de uma conexão persistente com um computador remoto. Com uma PSSession, você pode executar uma série de comandos que compartilham dados, como o valor de variáveis, o conteúdo de uma função ou a definição de um alias.
Você pode executar comandos remotos sem criar uma PSSession. Use o parâmetro ComputerName de cmdlets habilitados remotamente para executar um único comando ou uma série de comandos não relacionados em um ou muitos computadores.
Quando você usa o parâmetro ComputerName de Invoke-Command ou Enter-PSSession, o PowerShell estabelece uma conexão temporária com o computador remoto e fecha a conexão assim que o comando é concluído. Todos os elementos de dados criados são perdidos quando a conexão é fechada.
Outros cmdlets que têm um parâmetro ComputerName , como Get-Eventlog e Get-WmiObject, usam diferentes tecnologias de comunicação remota para coletar dados. Nenhum cria uma conexão persistente como uma PSSession.
Como Create uma PSSession
Para criar uma PSSession, use o New-PSSession cmdlet . Para criar a PSSession em um computador remoto, use o parâmetro ComputerName do New-PSSession cmdlet .
Por exemplo, o comando a seguir cria uma nova PSSession no computador Server01.
New-PSSession -ComputerName Server01
Quando você envia o comando, New-PSSession cria a PSSession e retorna um objeto que representa a PSSession. Você pode salvar o objeto em uma variável ao criar a PSSession ou usar um Get-PSSession comando para obter a PSSession posteriormente.
Por exemplo, o comando a seguir cria uma nova PSSession no computador Server01 e salva o objeto resultante na variável $ps.
$ps = New-PSSession -ComputerName Server01
Como Create PSSessions em vários computadores
Para criar PSSessions em vários computadores, use o parâmetro ComputerName do New-PSSession cmdlet . Digite os nomes dos computadores remotos em uma lista separada por vírgulas.
Por exemplo, para criar PSSessions nos computadores Server01, Server02 e Server03, digite:
New-PSSession -ComputerName Server01, Server02, Server03
New-PSSession cria uma PSSession em cada um dos computadores remotos.
Como obter PSSessions
Para obter as PSSessions que foram criadas em sua sessão atual, use o Get-PSSession cmdlet sem o parâmetro ComputerName . Get-PSSession retorna o mesmo tipo de objeto que New-PSSession retorna.
O comando a seguir obtém todas as PSSessionsions que foram criadas na sessão atual.
Get-PSSession
A exibição padrão das PSSessions mostra sua ID e um nome de exibição padrão. Você pode atribuir um nome de exibição alternativo ao criar a sessão.
Id Name ComputerName State ConfigurationName
--- ---- ------------ ----- ---------------------
1 Session1 Server01 Opened Microsoft.PowerShell
2 Session2 Server02 Opened Microsoft.PowerShell
3 Session3 Server03 Opened Microsoft.PowerShell
Você também pode salvar as PSSessions em uma variável. O comando a seguir obtém as PSSessions e as salva na variável $ps 123.
$ps123 = Get-PSSession
Ao usar os cmdlets PSSession, você pode se referir a uma PSSession por sua ID, por seu nome ou por sua ID de instância (um GUID). O comando a seguir obtém uma PSSession por sua ID e a salva na variável $ps 01.
$ps01 = Get-PSSession -Id 1
A partir do Windows PowerShell 3.0, as PSSessions são mantidas no computador remoto. Para obter PSSessions que você criou em computadores remotos específicos, use o parâmetro ComputerName do Get-PSSession cmdlet. O comando a seguir obtém as PSSessions que você criou no computador remoto Server01. Isso inclui PSSessions criados na sessão atual e em outras sessões no computador local ou em outros computadores.
Get-PSSession -ComputerName Server01
No Windows PowerShell 2.0, Get-PSSession obtém apenas as PSSessionsions que foram criadas na sessão atual. Ele não obtém PSSessions que foram criados em outras sessões ou em outros computadores, mesmo que as sessões estejam conectadas e estejam executando comandos no computador local.
Como executar comandos em uma PSSession
Para executar um comando em um ou mais PSSessions, use o Invoke-Command cmdlet .
Use o parâmetro Session para especificar as PSSessions e o parâmetro ScriptBlock para especificar o comando.
Por exemplo, para executar um comando ("dir") em cada uma Get-ChildItem das três PSSessions salvas na variável $ps 123, digite:
Invoke-Command -Session $ps123 -ScriptBlock { Get-ChildItem }
Como excluir PSSessions
Quando terminar de usar o PSSession, use o Remove-PSSession cmdlet para excluir o PSSession e liberar os recursos que ele estava usando.
Remove-PSSession -Session $ps
ou
Remove-PSSession -Id 1
Para remover uma PSSession de um computador remoto, use o parâmetro ComputerName do Remove-PSSession cmdlet .
Remove-PSSession -ComputerName Server01 -Id 1
Se você não excluir a PSSession, a PSSession permanecerá disponível para uso até atingir o tempo limite.
Você também pode usar o parâmetro IdleTimeout do New-PSSessionOption cmdlet para definir um tempo de expiração para uma PSSession ociosa. Para obter mais informações, consulte New-PSSessionOption.
Os cmdlets PSSession
Para obter uma lista de cmdlets PSSession, digite:
Get-Help *-PSSession
- Connect-PSSession: conecta uma PSSession à sessão atual
- Disconnect-PSSession: desconecta uma PSSession da sessão atual
- Enter-PSSession: inicia uma sessão interativa
- Exit-PSSession: encerra uma sessão interativa
- Get-PSSession: obtém as PSSessions na sessão atual
- New-PSSession: cria uma nova PSSession em um computador local ou remoto
- Receive-PSSession: obtém os resultados dos comandos executados em uma sessão desconectada
- Remove-PSSession: exclui as PSSessions na sessão atual
Observação
As sessões desconectadas só têm suporte no Windows. Os Connect-PSSessioncmdlets , Disconnect-PSSessione Receive-PSSession só estão disponíveis no Windows. Para obter mais informações sobre sessões desconectadas, consulte about_Remote_Disconnected_Session
Para obter mais informações
Para obter mais informações sobre PSSessions, consulte about_PSSession_Details.