Get-ConnectionInformation

Modulo:

Exchange PowerShell

Questo cmdlet è disponibile solo nel modulo Exchange Online PowerShell versione 3.0.0 o successiva. Per altre informazioni, vedere Informazioni sul modulo Exchange Online PowerShell.

Usare il cmdlet Get-ConnectionInformation per ottenere informazioni su tutte le connessioni basate su REST nell'istanza corrente di PowerShell con Exchange Online.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Default (impostazione predefinita).

Get-ConnectionInformation
    [<CommonParameters>]

ConnectionId

Get-ConnectionInformation
    -ConnectionId <String[]>
    [<CommonParameters>]

ModulePrefix

Get-ConnectionInformation
    -ModulePrefix <String[]>
    [<CommonParameters>]

Descrizione

Il cmdlet Get-ConnectionInformation restituisce le informazioni su tutte le connessioni basate su REST attive con Exchange Online nell'istanza corrente di PowerShell. Questo cmdlet equivale al cmdlet Get-PSSession usato con le sessioni remote di PowerShell.

L'output del cmdlet contiene le proprietà seguenti:

• ConnectionId: valore GUID univoco per la connessione. Ad esempio, 8b632b3a-a2e2-8ff3-adcd-6d119d07694b.
• Stato: ad esempio, Connesso.
• Id: numero intero che identifica la sessione nella finestra di PowerShell. La prima connessione è 1, la seconda è 2 e così via.
• Nome: nome univoco basato sull'ambiente PowerShell e sul valore id. Ad esempio, ExchangeOnline_1 per Exchange Online PowerShell o ExchangeOnlineProtection_1 per PowerShell di conformità & sicurezza.
• UserPrincipalName: account usato per la connessione. Ad esempio, laura@contoso.onmicrosoft.com.
• ConnectionUri: endpoint di connessione usato. Ad esempio, https://outlook.office365.com per Exchange Online PowerShell o https://nam12b.ps.compliance.protection.outlook.com per Security & Compliance PowerShell.
• AzureAdAuthorizationEndpointUri: endpoint di autorizzazione Microsoft Entra per la connessione. Ad esempio, https://login.microsoftonline.com/organizations per Exchange Online PowerShell o https://login.microsoftonline.com/organizations per Security & Compliance PowerShell.
• TokenExpiryTimeUTC: alla scadenza del token di connessione. Ad esempio, 30/9/2023 18:42:24 +00:00.
• CertificateAuthentication: indica se per la connessione è stata usata l'autenticazione basata su certificati (nota anche come autenticazione basata su CBA o solo app). I valori consentiti sono True o False.
• ModuleName: nome file e percorso dei dati temporanei per la sessione. Ad esempio, C:\Users\laura\AppData\Local\Temp\tmpEXO_a54z135k.qgv
• ModulePrefix: valore specificato usando il parametro Prefix nel comando Connect-ExchangeOnline o Connect-IPPSSession.
• Organizzazione: valore specificato usando il parametro Organization nel comando Connect-ExchangeOnline o Connect-IPPSSession per le connessioni di identità gestite o CBA.
• DelegatedOrganization: valore specificato usando il parametro DelegatedOrganization nel comando Connect-ExchangeOnline o Connect-IPPSSession.
• AppId: valore specificato usando il parametro AppId nel comando Connect-ExchangeOnline o Connect-IPPSSession per le connessioni CBA.
• PageSize: numero massimo predefinito di voci per pagina nella connessione. Il valore predefinito è 1000 oppure è possibile usare il parametro PageSize nel comando Connect-ExchangeOnline per specificare un numero inferiore. I singoli cmdlet possono anche avere un parametro PageSize.
• TenantID: valore GUID DELL'ID tenant. Ad esempio, 3750b40b-a68b-4632-9fb3-5b1aff664079.
• TokenStatus: ad esempio, Attivo.
• ConnectionUsedForInbuiltCmdlets
• IsEopSession: per Exchange Online connessioni di PowerShell, il valore è False. Per le connessioni PowerShell sicurezza & conformità, il valore è True.

Esempio

Esempio 1

Get-ConnectionInformation

In questo esempio viene restituito un elenco di tutte le connessioni basate su REST attive con Exchange Online nell'istanza corrente di PowerShell.

Esempio 2

Get-ConnectionInformation -ConnectionId 1a9e45e8-e7ec-498f-9ac3-0504e987fa85

In questo esempio viene restituita la connessione basata su REST attiva con il valore ConnectionId specificato.

Esempio 3

Get-ConnectionInformation -ModulePrefix Contoso,Fabrikam

In questo esempio viene restituito un elenco di connessioni basate su REST attive che usano i valori di prefisso specificati.

Parametri

-ConnectionId

Applicabile: Exchange Online

Nota: questo parametro è disponibile nella versione del modulo 3.2.0-Preview2 o successiva.

Il parametro ConnectionId filtra le connessioni in base a ConnectionId. ConnectionId è un valore GUID nell'output del cmdlet Get-ConnectionInformation che identifica in modo univoco una connessione, anche se sono aperte più connessioni. È possibile specificare più valori ConnectionId separati da virgole.

Non usare questo parametro con il parametro ModulePrefix.

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ConnectionId

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ModulePrefix

Applicabile: Exchange Online

Nota: questo parametro è disponibile nella versione del modulo 3.2.0-Preview2 o successiva.

Il parametro ModulePrefix filtra le connessioni in base a ModulePrefix. Quando si usa il parametro Prefix con il cmdlet Connect-ExchangeOnline, il testo specificato viene aggiunto ai nomi di tutti i cmdlet Exchange Online, ad esempio Get-InboundConnector diventa Get-ContosoInboundConnector. Il valore ModulePrefix è visibile nell'output del cmdlet Get-ConnectionInformation. È possibile specificare più valori ModulePrefix separati da virgole.

Questo parametro è significativo solo per le connessioni create con il parametro Prefix.

Non usare questo parametro con il parametro ConnectionId.

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ModulePrefix

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
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, vedere about_CommonParameters.