Get-PSSession
Ottiene le sessioni di PowerShell nei computer locali e remoti.
Sintassi
Name (Impostazione predefinita)
Get-PSSession
[-Name <String[]>]
[<CommonParameters>]
ComputerName
Get-PSSession
[-ComputerName] <String[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ComputerInstanceId
Get-PSSession
[-ComputerName] <String[]>
-InstanceId <Guid[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ConnectionUriInstanceId
Get-PSSession
[-ConnectionUri] <Uri[]>
-InstanceId <Guid[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ConnectionUri
Get-PSSession
[-ConnectionUri] <Uri[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ContainerId
Get-PSSession
-ContainerId <String[]>
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
[<CommonParameters>]
ContainerIdInstanceId
Get-PSSession
-InstanceId <Guid[]>
-ContainerId <String[]>
[-ConfigurationName <String>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMId
Get-PSSession
-VMId <Guid[]>
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMIdInstanceId
Get-PSSession
-InstanceId <Guid[]>
-VMId <Guid[]>
[-ConfigurationName <String>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMName
Get-PSSession
-VMName <String[]>
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMNameInstanceId
Get-PSSession
-InstanceId <Guid[]>
-VMName <String[]>
[-ConfigurationName <String>]
[-State <SessionFilterState>]
[<CommonParameters>]
InstanceId
Get-PSSession
[-InstanceId <Guid[]>]
[<CommonParameters>]
Id
Get-PSSession
[-Id] <Int32[]>
[<CommonParameters>]
Descrizione
Il Get-PSSession cmdlet ottiene le sessioni di PowerShell gestite dall'utente (PSSession) nei computer locali e remoti.
A partire da Windows PowerShell 3.0, le sessioni vengono archiviate nei computer all'estremità remota di ogni connessione. È possibile utilizzare i parametri ComputerName o ConnectionUri di Get-PSSession per ottenere le sessioni che si connettono al computer locale o ai computer remoti, anche se non sono state create nella sessione corrente.
Senza parametri, Get-PSSession ottiene tutte le sessioni create nella sessione corrente.
Usare i parametri di filtro, tra cui Name, Id, InstanceId, State, ApplicationName e ConfigurationName per selezionare tra le sessioni restituite Get-PSSession .
Usare i parametri rimanenti per configurare la connessione temporanea in cui viene eseguito il Get-PSSession comando quando si usano i parametri ComputerName o ConnectionUri .
Annotazioni
In Windows PowerShell 2.0, senza parametri, Get-PSSession ottiene tutte le sessioni create nella sessione corrente. Il parametro ComputerName consente di ottenere le sessioni create nella sessione corrente e di connettersi al computer specificato.
Per altre informazioni sulle sessioni di PowerShell, vedere about_PSSessions.
Esempio
Esempio 1: Ottenere le sessioni create nella sessione corrente
Get-PSSession
Questo comando ottiene tutte le sessioni PSSession create nella sessione corrente. Non riceve le sessioni PSSession create in altre sessioni o in altri computer, anche se si connettono a questo computer.
Esempio 2: Connettere le sessioni al computer locale
Get-PSSession -ComputerName "localhost"
Questo comando ottiene le sessioni PSSession connesse al computer locale. Per indicare il computer locale, digitare il nome del computer, localhost o un punto (.)
Il comando restituisce tutte le sessioni nel computer locale, anche se sono state create in sessioni diverse o in computer diversi.
Esempio 3: Connettere le sessioni a un computer
Get-PSSession -ComputerName "Server02"
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
2 Session3 Server02 Disconnected ITTasks Busy
1 ScheduledJobs Server02 Opened Microsoft.PowerShell Available
3 Test Server02 Disconnected Microsoft.PowerShell Busy
Questo comando ottiene le sessioni PSSession connesse al computer Server02.
Il comando restituisce tutte le sessioni su Server02, anche se sono state create in sessioni diverse o su computer diversi.
L'output mostra che due sessioni hanno uno Disconnected stato e una Busy disponibilità.
Sono stati creati in diverse sessioni e sono attualmente in uso. La ScheduledJobs sessione, ovvero Opened e Available, è stata creata nella sessione corrente.
Esempio 4: Salvare i risultati di questo comando
New-PSSession -ComputerName Server01, Server02, Server03
$s1, $s2, $s3 = Get-PSSession
In questo esempio viene illustrato come salvare i risultati di un Get-PSSession comando in più variabili.
Il primo comando usa il New-PSSession cmdlet per creare sessioni PSSession in tre computer remoti.
Il secondo comando usa un Get-PSSession cmdlet per ottenere le tre sessioni PSSession. Salva, quindi, ogni sessione PSSession in una variabile separata.
Quando PowerShell assegna una matrice di oggetti a una matrice di variabili, assegna il primo oggetto alla prima variabile, il secondo oggetto alla seconda variabile e così via. Se sono presenti più oggetti che variabili, assegna tutti gli oggetti rimanenti all'ultima variabile dell'array. Se sono presenti più variabili che oggetti, le variabili aggiuntive non vengono utilizzate.
Esempio 5: Eliminazione di una sessione utilizzando un ID istanza
Get-PSSession | Format-Table -Property ComputerName, InstanceId
$s = Get-PSSession -InstanceId a786be29-a6bb-40da-80fb-782c67f7db0f
Remove-PSSession -Session $s
In questo esempio viene illustrato come ottenere una sessione PSSession utilizzando il relativo ID istanza e quindi eliminare la sessione PSSession.
Il primo comando ottiene tutte le sessioni PSSession create nella sessione corrente. Invia le sessioni PSSession al Format-Table cmdlet , che visualizza le proprietà ComputerName e InstanceId di ogni PSSession.
Il secondo comando usa il Get-PSSession cmdlet per ottenere una specifica sessione PSSession e salvarla nella $s variabile. Il comando usa il parametro InstanceId per identificare la sessione PSSession.
Il terzo comando usa il cmdlet Remove-PSSession per eliminare la sessione PSSession nella $s variabile .
Esempio 6: Ottenere una sessione con un nome specifico
I comandi in questo esempio trovano una sessione con un particolare formato di nome e utilizzano una particolare configurazione di sessione, quindi si connettono alla sessione. È possibile utilizzare un comando come questo per trovare una sessione in cui un collega ha avviato un'attività e connettersi per completare l'attività.
Get-PSSession -ComputerName Server02, Server12 -Name BackupJob* -ConfigurationName ITTasks -SessionOption @{OperationTimeout=240000}
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
3 BackupJob04 Server02 Disconnected ITTasks None
$s = Get-PSSession -ComputerName Server02 -Name BackupJob04 -ConfigurationName ITTasks | Connect-PSSession
$s
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
5 BackupJob04 Server02 Opened ITTasks Available
Il primo comando ottiene sessioni nei computer remoti Server02 e Server12 con nomi che iniziano con BackupJob e usano la configurazione di ITTasks sessione. Il comando usa il parametro Name per specificare il modello di nome e il parametro ConfigurationName per specificare la configurazione della sessione. Il valore del parametro SessionOption è una tabella hash che imposta il valore di OperationTimeout su 240000 millisecondi (4 minuti). Questa impostazione consente di completare il comando più tempo. I parametri ConfigurationName e SessionOption vengono usati per configurare le sessioni temporanee in cui viene eseguito il Get-PSSession cmdlet in ogni computer. L'output mostra che il comando restituisce la BackupJob04 sessione. La sessione è disconnessa e la disponibilità è None, che indica che non è in uso.
Il secondo comando usa il Get-PSSession cmdlet per accedere alla BackupJob04 sessione e al Connect-PSSession cmdlet per connettersi alla sessione. Il comando salva la sessione nella $s variabile .
Il terzo comando ottiene la sessione nella $s variabile . L'output mostra che il Connect-PSSession comando ha avuto esito positivo. La sessione è nello stato Aperto ed è disponibile per l'uso.
Esempio 7: Ottenere una sessione utilizzando il relativo ID
Get-PSSession -Id 2
Questo comando ottiene la sessione PSSession con ID 2. Poiché il valore della proprietà Id è univoco solo nella sessione corrente, il parametro Id è valido solo per i comandi locali.
Parametri
-AllowRedirection
Indica che questo cmdlet consente il reindirizzamento di questa connessione a un URI (Uniform Resource Identifier) alternativo. Per impostazione predefinita, PowerShell non reindirizza le connessioni.
Questo parametro configura la connessione temporanea creata per eseguire un Get-PSSession comando con il parametro ConnectionUri .
Questo parametro è stato introdotto in Windows PowerShell 3.0.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ConnectionUriInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUri
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ApplicationName
Specifica il nome di un'applicazione. Questo cmdlet si connette solo alle sessioni che utilizzano l'applicazione specificata.
Immettere il segmento del nome dell'applicazione dell'URI di connessione. Ad esempio, nell'URI di connessione seguente, il nome dell'applicazione è WSMan: http://localhost:5985/WSMAN. Il nome dell'applicazione di una sessione viene archiviato nella proprietà Runspace.ConnectionInfo.AppName della sessione.
Il valore di questo parametro viene utilizzato per selezionare e filtrare le sessioni. Non modifica l'applicazione utilizzata dalla sessione.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | All sessions |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Authentication
Specifica il meccanismo utilizzato per autenticare le credenziali per la sessione in cui viene eseguito il Get-PSSession comando.
Questo parametro configura la connessione temporanea creata per eseguire un Get-PSSession comando con il parametro ComputerName o ConnectionUri .
I valori accettabili per questo parametro sono:
DefaultBasicCredSSPDigestKerberosNegotiate-
NegotiateWithImplicitCredential.
Il valore predefinito è Default.
Per ulteriori informazioni sui valori di questo parametro, consultare Enumerazione del Meccanismo di Autenticazione.
Attenzione
L'autenticazione credSSP (Credential Security Support Provider), in cui le credenziali dell'utente vengono passate a un computer remoto da autenticare, è progettato per i comandi che richiedono l'autenticazione su più di una risorsa, ad esempio l'accesso a una condivisione di rete remota. Questo meccanismo aumenta il rischio di sicurezza dell'operazione remota. Se il computer remoto viene compromesso, è possibile usare le credenziali passate per controllare la sessione di rete.
Questo parametro è stato introdotto in Windows PowerShell 3.0.
Proprietà dei parametri
| Tipo: | AuthenticationMechanism |
| Valore predefinito: | Default |
| Valori accettati: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUri
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUriInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CertificateThumbprint
Specifica il certificato di chiave pubblica digitale (X509) di un account utente autorizzato a creare la sessione in cui viene eseguito il Get-PSSession comando. Immettere l'impronta digitale del certificato.
Questo parametro configura la connessione temporanea creata per eseguire un Get-PSSession comando con il parametro ComputerName o ConnectionUri .
I certificati vengono usati nell'autenticazione basata su certificati client. Possono essere mappati solo agli account utente locali; non funzionano con gli account di dominio.
Per ottenere un'identificazione personale del certificato, usare un Get-Item comando o Get-ChildItem nell'unità di PowerShell Cert: .
Questo parametro è stato introdotto in Windows PowerShell 3.0.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUri
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUriInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ComputerName
Specifica una matrice di nomi di computer. Ottiene le sessioni che si connettono ai computer specificati. I caratteri jolly non sono consentiti. Non esiste alcun valore predefinito.
A partire da Windows PowerShell 3.0, gli oggetti PSSession vengono archiviati nei computer all'estremità remota di ogni connessione. Per ottenere le sessioni nei computer specificati, PowerShell crea una connessione temporanea a ogni computer ed esegue un Get-PSSession comando.
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, localhosto un punto (.).
Annotazioni
Questo parametro ottiene sessioni solo dai computer che eseguono Windows PowerShell 3.0 o versioni successive di PowerShell. Le versioni precedenti non memorizzano le sessioni.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | CN |
Set di parametri
ComputerInstanceId
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ComputerName
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-ConfigurationName
Specifica il nome di una configurazione. Questo cmdlet consente di accedere solo alle sessioni che utilizzano la configurazione di sessione specificata.
Immettere un nome di configurazione o l'URI completo della risorsa per una configurazione di sessione. Se si specifica solo il nome di configurazione, viene anteporto l'URI dello schema seguente: http://schemas.microsoft.com/powershell. Il nome di configurazione di una sessione viene archiviato nella proprietà ConfigurationName della sessione.
Il valore di questo parametro viene utilizzato per selezionare e filtrare le sessioni. Non modifica la configurazione della sessione utilizzata dalla sessione.
Per altre informazioni sulle configurazioni di sessione, vedere about_Session_Configurations.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | All sessions |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ConnectionUri
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ConnectionUriInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ContainerId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ContainerIdInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
VMId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
VMIdInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
VMName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
VMNameInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-ConnectionUri
Specifica un URI che definisce l'endpoint di connessione per la sessione temporanea in cui viene eseguito il Get-PSSession comando. L'URI deve essere completo.
Questo parametro configura la connessione temporanea creata per eseguire un Get-PSSession comando con il parametro ConnectionUri .
Il formato di questa stringa è:
<Transport>://<ComputerName>:<Port\>/<ApplicationName>
Il valore predefinito è: http://localhost:5985/WSMAN.
Se non si specifica un oggetto ConnectionUri, è possibile utilizzare i parametri UseSSL, ComputerName, Port e ApplicationName per specificare i valori ConnectionURI . I valori validi per il segmento Transport dell'URI sono HTTP e HTTPS. Se si specifica un URI di connessione con un segmento di trasporto, ma non si specifica una porta, la sessione viene creata con porte standard: 80 per HTTP e 443 per HTTPS. Per usare le porte predefinite per la comunicazione remota di PowerShell, specificare la porta 5985 per HTTP o 5986 per HTTPS.
Se il computer di destinazione reindirizza la connessione a un URI diverso, PowerShell impedisce il reindirizzamento a meno che non si usi il parametro AllowRedirection nel comando .
Questo parametro è stato introdotto in Windows PowerShell 3.0.
Questo parametro ottiene le sessioni solo dai computer che eseguono Windows PowerShell 3.0 o versioni successive di Windows PowerShell. Le versioni precedenti non memorizzano le sessioni.
Proprietà dei parametri
| Tipo: | Uri[] |
| Valore predefinito: | Http://localhost:5985/WSMAN |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | URI (Identificatore Uniforme delle Risorse), CU |
Set di parametri
ConnectionUri
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ConnectionUriInstanceId
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-ContainerId
Specifica una matrice di ID di contenitori. Questo cmdlet avvia una sessione interattiva con ognuno dei contenitori specificati. Usare il comando docker ps per ottenere un elenco di ID contenitore. Per ulteriori informazioni, consultare la help per il comando docker ps.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ContainerId
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ContainerIdInstanceId
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Credential
Specifica una credenziale utente. Questo cmdlet esegue il comando con le autorizzazioni dell'utente specificato. Specificare un account utente autorizzato a connettersi al computer remoto ed eseguire un Get-PSSession comando. Il valore predefinito è l'utente corrente.
Digitare un nome utente, ad esempio User01 o Domain01\User01, oppure immettere un oggetto PSCredential generato dal Get-Credential cmdlet . Se si digita un nome utente, viene richiesto di immettere la password.
Le credenziali vengono archiviate in un oggetto PSCredential e la password viene archiviata come SecureString.
Annotazioni
Per ulteriori informazioni sulla protezione dei dati di SecureString, vedere Quanto è sicuro SecureString?.
Questo parametro consente di configurare la connessione temporanea creata per eseguire un Get-PSSession comando con il parametro ComputerName o ConnectionUri .
Questo parametro è stato introdotto in Windows PowerShell 3.0.
Proprietà dei parametri
| Tipo: | PSCredential |
| Valore predefinito: | Current user |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUri
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUriInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Id
Specifica una matrice di ID sessione. Questo cmdlet ottiene solo le sessioni con gli ID specificati. Digitare uno o più ID, separati da virgole o usare l'operatore di intervallo (..) per specificare un intervallo di ID.
Non è possibile utilizzare il parametro Id insieme al parametro ComputerName .
Un ID è un numero intero che identifica in modo univoco le sessioni gestite dall'utente nella sessione corrente. È più facile da ricordare e digitare rispetto a InstanceId, ma è univoco solo all'interno della sessione corrente. L'ID di una sessione viene archiviato nella proprietà Id della sessione.
Proprietà dei parametri
| Tipo: | Int32[] |
| Valore predefinito: | All sessions |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Id
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-InstanceId
Specifica una matrice di ID istanza di sessioni. Questo cmdlet ottiene solo le sessioni con gli ID istanza specificati.
L'ID istanza è un GUID che identifica in modo univoco una sessione in un computer locale o remoto. L'InstanceId è univoco, anche quando hai più sessioni in esecuzione su PowerShell.
L'ID istanza di una sessione viene archiviato nella proprietà InstanceId della sessione.
Proprietà dei parametri
| Tipo: | Guid[] |
| Valore predefinito: | All sessions |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerInstanceId
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUriInstanceId
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ContainerIdInstanceId
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
VMIdInstanceId
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
VMNameInstanceId
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
InstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Specifica una matrice di nomi di sessione. Questo cmdlet ottiene solo le sessioni con i nomi descrittivi specificati. Sono consentiti caratteri jolly.
Il nome descrittivo di una sessione viene archiviato nella proprietà Name della sessione.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | All sessions |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
Set di parametri
Name
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ConnectionUri
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ContainerId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
VMId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
VMName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Port
Specifica la porta di rete specificata utilizzata per la connessione temporanea in cui viene eseguito il Get-PSSession comando. Per connettersi a un computer remoto, il computer remoto deve essere in ascolto sulla porta usata dalla connessione. Le porte predefinite sono 5985, ovvero la porta WinRM per HTTP e 5986, ovvero la porta WinRM per HTTPS.
Prima di usare una porta alternativa, è necessario configurare il listener WinRM nel computer remoto per l'ascolto su tale porta. Per configurare il listener, digitare i due comandi seguenti al prompt di PowerShell:
Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse
New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>
Questo parametro consente di configurare la connessione temporanea creata per eseguire un Get-PSSession comando con il parametro ComputerName o ConnectionUri .
Non usare il parametro porta a meno che non sia necessario. La porta impostata nel comando si applica a tutti i computer o le sessioni in cui viene eseguito il comando. Un'impostazione di porta alternativa potrebbe impedire l'esecuzione del comando in tutti i computer.
Questo parametro è stato introdotto in Windows PowerShell 3.0.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 5985, 5986 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SessionOption
Specifica le opzioni avanzate per la sessione. Immettere un oggetto SessionOption , ad esempio uno creato utilizzando il New-PSSessionOption cmdlet, o una tabella hash in cui le chiavi sono nomi di opzioni di sessione e i valori sono valori di opzioni di sessione.
I valori predefiniti per le opzioni sono determinati dal valore della variabile di preferenza $PSSessionOption, se impostata. In caso contrario, i valori predefiniti vengono stabiliti dalle opzioni impostate nella configurazione della sessione.
I valori delle opzioni di sessione hanno la precedenza sui valori predefiniti per le sessioni impostate nella $PSSessionOption variabile di preferenza e nella configurazione della sessione. Tuttavia, non hanno la precedenza sui valori massimi, sulle quote o sui limiti impostati nella configurazione della sessione.
Per una descrizione delle opzioni di sessione, inclusi i valori predefiniti, vedere New-PSSessionOption.
Per informazioni sulla $PSSessionOption variabile di preferenza, vedere about_Preference_Variables. Per altre informazioni sulle configurazioni di sessione, vedere about_Session_Configurations.
Proprietà dei parametri
| Tipo: | PSSessionOption |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUri
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUriInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-State
Specifica uno stato della sessione. Questo cmdlet ottiene solo le sessioni nello stato specificato. I valori accettabili per questo parametro sono: All, Opened, Disconnected, Closede Broken. Il valore predefinito è All.
Il valore dello stato della sessione è relativo alle sessioni correnti. Le sessioni non create nelle sessioni correnti e non sono connesse alla sessione corrente hanno uno stato Disconnected anche quando sono connesse a una sessione diversa.
Lo stato di una sessione viene archiviato nella proprietà State della sessione.
Questo parametro è stato introdotto in Windows PowerShell 3.0.
Proprietà dei parametri
| Tipo: | SessionFilterState |
| Valore predefinito: | All |
| Valori accettati: | All, Opened, Disconnected, Closed, Broken |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUri
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUriInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ContainerId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ContainerIdInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
VMId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
VMIdInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
VMName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
VMNameInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ThrottleLimit
Specifica il numero massimo di connessioni simultanee che è possibile stabilire per eseguire il Get-PSSession comando. Se si omette questo parametro o si immette un valore pari 0 a (zero), viene usato il valore predefinito , 32. Il limite di limitazione si applica solo al comando corrente, non alla sessione o al computer.
Questo parametro è stato introdotto in Windows PowerShell 3.0.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 32 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUri
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ConnectionUriInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-UseSSL
Indica che questo cmdlet usa il protocollo SSL (Secure Sockets Layer) per stabilire la connessione in cui viene eseguito il Get-PSSession comando. Per impostazione predefinita, SSL non viene usato. Se si usa questo parametro, ma SSL non è disponibile sulla porta usata per il comando, il comando ha esito negativo.
Questo parametro configura la connessione temporanea creata per eseguire un Get-PSSession comando con il parametro ComputerName .
Questo parametro è stato introdotto in Windows PowerShell 3.0.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerInstanceId
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-VMId
Specifica una matrice di ID di macchine virtuali. Questo cmdlet avvia una sessione interattiva con ognuna delle macchine virtuali specificate. Per visualizzare le macchine virtuali disponibili, usare il comando seguente:
Get-VM | Select-Object -Property Name, ID
Proprietà dei parametri
| Tipo: | Guid[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | VMGuid |
Set di parametri
VMId
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
VMIdInstanceId
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-VMName
Specifica una matrice di nomi di macchine virtuali. Questo cmdlet avvia una sessione interattiva con ognuna delle macchine virtuali specificate. Per visualizzare le macchine virtuali disponibili, usare il cmdlet Get-VM.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
VMName
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
VMNameInstanceId
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
None
Gli oggetti non possono essere inviati tramite pipe a questo cmdlet.
Output
PSSession
Note
Windows PowerShell include gli alias seguenti per Get-PSSession:
gsnQuesto cmdlet ottiene oggetti PSSession di sessioni gestite dall'utente, ad esempio quelli creati usando i
New-PSSessioncmdlet ,Enter-PSSessioneInvoke-Command. Non ottiene la sessione gestita dal sistema creata all'avvio di PowerShell.A partire da Windows PowerShell 3.0, gli oggetti PSSession vengono archiviati nel computer che si trova sul lato server o che riceve una connessione. Per ottenere le sessioni archiviate nel computer locale o in un computer remoto, PowerShell stabilisce una sessione temporanea nel computer specificato ed esegue comandi di query nella sessione.
Per ottenere sessioni che si connettono a un computer remoto, utilizzare i parametri ComputerName o ConnectionUri per specificare il computer remoto. Per filtrare le sessioni ottenute
Get-PSSession, usare i parametri Name, Id, InstanceId e State . Usare i parametri rimanenti per configurare la sessioneGet-PSSessiontemporanea usata.Quando si usano i parametri ComputerName o ConnectionUri ,
Get-PSSessionottiene solo le sessioni dai computer che eseguono Windows PowerShell 3.0 e versioni successive di PowerShell.Il valore della proprietà State di una sessione PSSession è relativo alla sessione corrente. Pertanto, il valore Disconnected indica che la sessione PSSession non è connessa alla sessione corrente. Tuttavia, ciò non significa che la sessione PSSession sia disconnessa da tutte le sessioni. Potrebbe essere connesso a una sessione diversa. Per determinare se è possibile connettersi o riconnettersi a PSSession dalla sessione corrente, utilizzare la proprietà Availability .
Un valore availability di None indica che è possibile connettersi alla sessione. Il valore Occupato indica che non è possibile connettersi a PSSession perché è connesso a un'altra sessione.
Per ulteriori informazioni sui valori della proprietà State delle sessioni, vedere Enumerazione RunspaceState.
Per ulteriori informazioni sui valori della proprietà Availability delle sessioni, vedere Enumerazione RunspaceAvailability.
