Ottiene le sessioni di Windows PowerShell (PSSession) nella sessione corrente.
Sintassi
Get-PSSession [[-ComputerName] <string[]>] [<CommonParameters>] Get-PSSession [-Id] <Int32[]> [<CommonParameters>] Get-PSSession [-InstanceId <Guid[]>] [<CommonParameters>] Get-PSSession [-Name <string[]>] [<CommonParameters>]
Descrizione
Il cmdlet Get-PSSession ottiene le sessioni di Windows PowerShell (PSSession) create nella sessione corrente.
Senza parametri, Get-PSSession consente di ottenere tutte le sessioni PSSession create nella sessione corrente. È possibile utilizzare i parametri di Get-PSSession per ottenere le sessioni connesse a particolari computer o identificare le sessioni in base ai relativi nomi, ID o ID istanza.
Per ulteriori informazioni sulle sessioni di Windows PowerShell, vedere about_PSSessions.
Parametri
-ComputerName <string[]>
Ottiene solo le sessioni PSSession connesse ai computer specificati. È consentito l'utilizzo di caratteri jolly.
Digitare il nome NetBIOS, un indirizzo IP o un nome di dominio completo di uno o più computer. Per specificare il computer locale, digitare il nome del computer, "localhost" o un punto (.).
|
Obbligatorio? |
false |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
true |
-Id <Int32[]>
Ottiene solo le sessioni PSSession con gli ID specificati. Digitare uno o più ID (separati da virgole) o utilizzare l'operatore intervallo (..) per specificare un intervallo di ID.
Un ID è un valore intero che identifica in modo univoco la sessione PSSession nella sessione corrente. È più facile da ricordare e digitare rispetto all'ID istanza, ma è univoco solo nella sessione corrente. Per trovare l'ID di una sessione PSSession, utilizzare Get-PSSession senza parametri.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
All sessions in the shell |
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-InstanceId <Guid[]>
Ottiene solo le sessioni PSSession con gli ID istanza specificati.
L'ID istanza è un GUID che identifica in modo univoco una sessione PSSession in un computer locale o remoto. InstanceID è univoco, anche quando si dispone di più sessioni in esecuzione in Windows PowerShell.
InstanceID viene archiviato nella proprietà InstanceID dell'oggetto che rappresenta una sessione PSSession. Per trovare l'ID istanza delle sessioni PSSession nella sessione corrente, digitare "get-pssession | Format-Table Name, ComputerName, InstanceId".
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
true |
-Name <string[]>
Ottiene solo le sessioni PSSession con i nomi descrittivi specificati. È consentito l'utilizzo di caratteri jolly.
Per trovare i nomi delle sessioni PSSession della sessione corrente, digitare "get-pssession" senza parametri.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
true |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
Nessuno Non è possibile reindirizzare l'input a questo cmdlet. |
|
Output |
System.Management.Automation.Runspaces.PSSession Get-PSSession restituisce un oggetto PSSession per ogni sessione PSSession ottenuta. |
Note
Get-PSSession consente di ottenere le sessioni PSSession create nella sessione corrente. Non viene ottenuta la sessione creata all'apertura di Windows PowerShell e non vengono ottenute le sessioni PSSession create in altre sessioni o in altri computer, anche se sono connessi al computer locale.
Esempio 1
C:\PS>get-pssession Descrizione ----------- Tramite questo comando vengono ottenute tutte le sessioni PSSession create nella sessione corrente. Non vengono ottenute le sessioni PSSession create in altre sessioni o in altri computer, anche se sono connessi a questo computer.
Esempio 2
C:\PS>$s = get-pssession -computername Server02 Descrizione ----------- Tramite questo comando vengono ottenute le sessioni PSSession connesse al computer Server02 e vengono salvate nella variabile $p.
Esempio 3
C:\PS>new-pssession -computername Server01, Server02, Server03 C:\PS> $s1, $s2, $s3 = get-pssession Descrizione ----------- In questo esempio viene illustrato come salvare i risultati di un comando Get-PSSession in più variabili. Nel primo comando viene utilizzato il cmdlet New-PSSession per creare sessioni PSSession in tre computer remoti. Nel secondo comando viene utilizzato un cmdlet Get-PSSession per ottenere le tre sessioni PSSession. Successivamente ogni sessione PSSession viene salvata in una variabile separata. In Windows PowerShell, quando si assegna una matrice di oggetti a una matrice di variabili, il primo oggetto viene assegnato alla prima variabile, il secondo oggetto alla seconda variabile e così via. Se sono presenti più oggetti che variabili, tutti gli oggetti rimanenti vengono assegnati all'ultima variabile della matrice. Se sono presenti più variabili che oggetti, le variabili supplementari non vengono utilizzate.
Esempio 4
C:\PS>get-pssession | format-table -property computername, InstanceID C:\PS> $s = get-pssession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f C:\PS> remove-pssession -session $s Descrizione ----------- In questo esempio viene illustrato come ottenere una sessione PSSession tramite il relativo ID istanza e successivamente come eliminarla. Con il primo comando si ottengono tutte le sessioni PSSession nel computer locale. Le sessioni PSSession vengono inviate al cmdlet Format-Table, in cui vengono visualizzate le proprietà ComputerName e InstanceID di ogni sessione PSSession. Nel secondo comando viene utilizzato il cmdlet Get-PSSession per ottenere una determinata sessione PSSession e per salvarla nella variabile $s. Viene utilizzato il parametro InstanceID per identificare la sessione PSSession. Nel terzo comando viene utilizzato il cmdlet Remove-PSSession per eliminare la sessione PSSession nella variabile $s.
Esempio 5
C:\PS>get-pssession -computername Serv* Descrizione ----------- Tramite questo comando vengono ottenute tutte le sessioni PSSession che si connettono a computer i cui nomi iniziano con "Serv".
Esempio 6
C:\PS>get-pssession -name Test*, Ux* Descrizione ----------- Tramite questo comando vengono ottenute le sessioni PSSession i cui nomi iniziano con "Test" o "Ux".
Esempio 7
C:\PS>get-pssession 2 Descrizione ----------- Tramite questo comando viene ottenuta la sessione PSSession con ID 2.
Vedere anche