about_PSSessions

Descrizione breve

Descrive le sessioni di Windows PowerShell (PSSession) e spiega come stabilire una connessione permanente a un computer remoto.

Descrizione lunga

Per eseguire comandi di Windows PowerShell in un computer remoto, è possibile usare il parametro ComputerName di un cmdlet oppure creare una sessione di Windows PowerShell (PSSession) ed eseguire i comandi nella sessione PSSession.

Quando si crea una PSSession, Windows PowerShell stabilisce una connessione permanente al computer remoto. Usare una sessione PSSession per eseguire una serie di comandi correlati in un computer remoto. I comandi eseguiti nella stessa sessione PSSession possono condividere dati, ad esempio i valori di variabili, alias e funzioni.

È anche possibile creare una sessione PSSession nel computer locale ed eseguirvi comandi. Una sessione PSSession locale usa l'infrastruttura di comunicazione remota di Windows PowerShell per creare e gestire la sessione PSSession.

A partire da Windows PowerShell 3.0, le sessioni PSSession sono indipendenti dalle sessioni in cui vengono create. Le sessioni PSSession attive vengono mantenute nel computer remoto (o nel computer alla fine remota o sul lato server della connessione). Di conseguenza, è possibile disconnettersi dalla sessione PSSession e riconnettersi a esso in un secondo momento dallo stesso computer o da un altro computer.

In questo argomento viene illustrato come creare, usare, ottenere ed eliminare le sessioni PSSession. Per informazioni più avanzate, vedere about_PSSession_Details.

Nota: le sessioni PSSession usano l'infrastruttura remota di Windows PowerShell. Per usare le sessioni PSSession, i computer locali e remoti devono essere configurati per la comunicazione remota. Per altre informazioni, vedere about_Remote_Requirements.

In Windows Vista e versioni successive di Windows, per creare una sessione PSSession in un computer locale, è necessario avviare Windows PowerShell con l'opzione "Esegui come amministratore".

Che cos'è una sessione?

Una sessione è un ambiente in cui viene eseguito Windows PowerShell.

Ogni volta che si avvia Windows PowerShell, viene creata automaticamente una sessione ed è possibile eseguire i comandi nella sessione. È anche possibile aggiungere elementi alla sessione, ad esempio moduli e snap-in, ed è possibile creare elementi, ad esempio variabili, funzioni e alias. Questi elementi esistono solo nella sessione e vengono eliminati al termine della sessione.

È anche possibile creare sessioni gestite dall'utente, note come sessioni di Windows PowerShell o "PSSessions", nel computer locale o in un computer remoto. Analogamente alla sessione predefinita, è possibile eseguire comandi in una sessione PSSession e aggiungere e creare elementi. Tuttavia, a differenza della sessione che viene avviata automaticamente, è possibile controllare le sessioni PSSession create. È possibile ottenere, creare, configurare e rimuoverli, disconnetterli e riconnettersi a essi ed eseguire più comandi nella stessa sessione PSSession. La sessione PSSession rimane disponibile fino a quando non viene eliminata o si verifica il timeout.

In genere, si crea una sessione PSSession per eseguire una serie di comandi correlati in un computer remoto. Quando si crea una sessione PSSession in un computer remoto, Windows PowerShell stabilisce una connessione permanente al computer remoto per supportare la sessione.

Se si usa il parametro ComputerName del Invoke-Command cmdlet o Enter-PSSession per eseguire un comando remoto o per avviare una sessione interattiva, Windows PowerShell crea una sessione temporanea nel computer remoto e chiude la sessione non appena il comando viene completato o non appena termina la sessione interattiva. Non è possibile controllare queste sessioni temporanee e non è possibile usarle per più di un singolo comando o di una singola sessione interattiva.

In Windows PowerShell, la "sessione corrente" è la sessione in cui si sta lavorando. La "sessione corrente" può fare riferimento a qualsiasi sessione, inclusa una sessione temporanea o una sessione PSSession.

Perché usare una sessione PSSession?

Usare una sessione PSSession quando è necessaria una connessione permanente a un computer remoto. Con una sessione PSSession è possibile eseguire una serie di comandi che condividono dati, ad esempio il valore delle variabili, il contenuto di una funzione o la definizione di un alias.

È possibile eseguire comandi remoti senza creare una sessione PSSession. Usare il parametro ComputerName dei cmdlet abilitati per la modalità remota per eseguire un singolo comando o una serie di comandi non correlati in uno o più computer.

Quando si usa il parametro ComputerName di Invoke-Command o Enter-PSSession, Windows PowerShell stabilisce una connessione temporanea al computer remoto e quindi chiude la connessione non appena il comando viene completato. Tutti gli elementi dati creati vengono persi quando la connessione viene chiusa.

Altri cmdlet con un parametro ComputerName , ad esempio Get-Eventlog e Get-WmiObject, usano tecnologie di comunicazione remota diverse per raccogliere dati. Nessuno crea una connessione persistente come una sessione PSSession.

Come creare una sessione PSSession

Per creare una sessione PSSession, usare il New-PSSession cmdlet . Per creare la sessione PSSession in un computer remoto, usare il parametro ComputerName del New-PSSession cmdlet .

Ad esempio, il comando seguente crea una nuova sessione PSSession nel computer Server01.

New-PSSession -ComputerName Server01

Quando si invia il comando, New-PSSession crea la sessione PSSession e restituisce un oggetto che rappresenta la sessione PSSession. È possibile salvare l'oggetto in una variabile quando si crea la sessione PSSession oppure è possibile usare un Get-PSSession comando per ottenere la sessione PSSession in un secondo momento.

Ad esempio, il comando seguente crea una nuova sessione PSSession nel computer Server01 e salva l'oggetto risultante nella variabile $ps.

$ps = New-PSSession -ComputerName Server01

Come creare sessioni PSSession in più computer

Per creare sessioni PSSession in più computer, usare il parametro ComputerName del New-PSSession cmdlet . Digitare i nomi dei computer remoti in un elenco delimitato da virgole.

Ad esempio, per creare sessioni PSSession nei computer Server01, Server02 e Server03, digitare:

New-PSSession -ComputerName Server01, Server02, Server03

New-PSSession crea una sessione PSSession in ognuno dei computer remoti.

Come ottenere le sessioni PSSession

Per ottenere le sessioni PSSession create nella sessione corrente, usare il Get-PSSession cmdlet senza il parametro ComputerName . Get-PSSession restituisce lo stesso tipo di oggetto restituito New-PSSession .

Il comando seguente ottiene tutte le sessioni PSSession create nella sessione corrente.

Get-PSSession

La visualizzazione predefinita delle sessioni PSSession mostra l'ID e un nome visualizzato predefinito. È possibile assegnare un nome visualizzato alternativo quando si crea la sessione.

Id   Name       ComputerName    State    ConfigurationName
---  ----       ------------    -----    ---------------------
1    Session1   Server01        Opened   Microsoft.PowerShell
2    Session2   Server02        Opened   Microsoft.PowerShell
3    Session3   Server03        Opened   Microsoft.PowerShell

È anche possibile salvare le sessioni PSSession in una variabile. Il comando seguente ottiene le sessioni PSSession e le salva nella variabile $ps 123.

$ps123 = Get-PSSession

Quando si usano i cmdlet PSSession, è possibile fare riferimento a una sessione PSSession in base al relativo ID, al nome o al relativo ID istanza (GUID). Il comando seguente ottiene una sessione PSSession in base al relativo ID e la salva nella variabile $ps 01.

$ps01 = Get-PSSession -Id 1

A partire da Windows PowerShell 3.0, le sessioni PSSession vengono mantenute nel computer remoto. Per ottenere le sessioni PSSession create in computer remoti specifici, usare il parametro ComputerName del Get-PSSession cmdlet . Il comando seguente ottiene le sessioni PSSession create nel computer remoto Server01. Sono incluse le sessioni PSSession create nella sessione corrente e in altre sessioni nel computer locale o in altri computer.

Get-PSSession -ComputerName Server01

In Windows PowerShell 2.0 Get-PSSession ottiene solo le sessioni PSSession create nella sessione corrente. Non ottiene le sessioni PSSession create in altre sessioni o in altri computer, anche se le sessioni sono connesse a e e eseguono comandi nel computer locale.

Come eseguire comandi in una sessione PSSession

Per eseguire un comando in una o più sessioni PSSession, usare il Invoke-Command cmdlet . Usare il parametro Session per specificare pssessioni e il parametro ScriptBlock per specificare il comando.

Ad esempio, per eseguire un Get-ChildItem comando ("dir") in ognuna delle tre sessioni PSSession salvate nella variabile $ps 123, digitare:

Invoke-Command -Session $ps123 -ScriptBlock { Get-ChildItem }

Come eliminare le sessioni PSSession

Al termine della sessione PSSession, usare il Remove-PSSession cmdlet per eliminare la sessione PSSession e rilasciare le risorse in uso.

Remove-PSSession -Session $ps

or

Remove-PSSession -Id 1

Per rimuovere una sessione PSSession da un computer remoto, usare il parametro ComputerName del Remove-PSSession cmdlet .

Remove-PSSession -ComputerName Server01 -Id 1

Se non si elimina la sessione PSSession, la sessione PSSession rimane disponibile per l'uso fino al timeout.

È anche possibile usare il parametro IdleTimeout del New-PSSessionOption cmdlet per impostare un'ora di scadenza per una SESSIONE PSSession inattiva. Per altre informazioni, vedere New-PSSessionOption.

Cmdlet PSSession

Per un elenco di cmdlet PSSession, digitare:

Get-Help *-PSSession
  • Connessione-PSSession: Connessione una sessione PSSession alla sessione corrente
  • Disconnect-PSSession: disconnette una sessione PSSession dalla sessione corrente
  • Enter-PSSession: avvia una sessione interattiva
  • Exit-PSSession: termina una sessione interattiva
  • Get-PSSession: ottiene le sessioni PSSession nella sessione corrente
  • New-PSSession: crea una nuova sessione PSSession in un computer locale o remoto
  • Receive-PSSession: ottiene i risultati dei comandi eseguiti in una sessione disconnessa
  • Remove-PSSession: elimina le sessioni PSSession nella sessione corrente

Per Ulteriori Informazioni

Per altre informazioni sulle sessioni PSSession, vedere about_PSSession_Details.

Vedi anche