Get-ConnectionInformation

Modulo:
Exchange PowerShell

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

Usare il cmdlet Get-ConnectionInformation per ottenere informazioni su tutte le connessioni basate su REST nell'istanza di PowerShell corrente 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 di PowerShell corrente. Questo cmdlet equivale al cmdlet Get-PSSession usato con le sessioni di PowerShell remote.

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 di PowerShell e sul valore dell'ID. Ad esempio, ExchangeOnline_1 per Exchange Online PowerShell o ExchangeOnlineProtection_1 per PowerShell per la sicurezza & la conformità.
  • UserPrincipalName: l'account usato per la connessione. Ad esempio, laura@contoso.onmicrosoft.com.
  • ConnectionUri: endpoint di connessione in uso. Ad esempio, https://outlook.office365.com per Exchange Online PowerShell o https://nam12b.ps.compliance.protection.outlook.com per PowerShell per la sicurezza & la conformità.
  • AzureAdAuthorizationEndpointUri : endpoint di autorizzazione di Microsoft Entra per la connessione. Ad esempio, https://login.microsoftonline.com/organizations per Exchange Online PowerShell o https://login.microsoftonline.com/organizations per PowerShell per la sicurezza & la conformità.
  • TokenExpiryTimeUTC: quando scade il token di connessione. Ad esempio, 30/09/2023 18:42:24 +00:00.
  • CertificateAuthentication: indica se per la connessione è stata usata l'autenticazione basata su certificato (nota anche come autenticazione CBA o autenticazione solo app). I valori consentiti sono True o False.
  • ModuleName: nome file e percorso dei dati temporanei per la sessione. Ad esempio, C:\Utenti\laura\AppData\Local\Temp\tmpEXO_a54z135k.qgv
  • ModulePrefix: il valore specificato utilizzando il parametro Prefix nel comando Connect-ExchangeOnline o Connect-IPPSSession.
  • Organizzazione: il valore specificato utilizzando il parametro Organization nel comando Connect-ExchangeOnline o Connect-IPPSSession per le connessioni CBA o di identità gestita.
  • DelegatedOrganization: il valore specificato utilizzando il parametro DelegatedOrganization nel comando Connect-ExchangeOnline o Connect-IPPSSession.
  • AppId: il valore specificato utilizzando il parametro AppId nel comando Connect-ExchangeOnline o Connect-IPPSSession per le connessioni CBA.
  • PageSize: il 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 più basso. 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 le connessioni PowerShell di Exchange Online, il valore è False. Per le connessioni PowerShell di 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 di PowerShell corrente.

Esempio 2

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

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

Esempio 3

Get-ConnectionInformation -ModulePrefix Contoso,Fabrikam

Questo esempio restituisce 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.