Connect-ExchangeOnline
Questo cmdlet è disponibile solo nel modulo Exchange Online PowerShell. Per altre informazioni, vedere Informazioni sul modulo Exchange Online PowerShell.
Usare il cmdlet Connect-ExchangeOnline nel modulo powershell Exchange Online per usare l'autenticazione moderna per connettersi a Exchange Online PowerShell o Exchange Online Protection PowerShell per la protezione cloud degli ambienti di posta elettronica locali. Questo cmdlet funziona per gli account con o senza multi-factor authentication (MFA).
Per connettersi a Security & Compliance PowerShell, usare il cmdlet Connect-IPPSSession .
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
Connect-ExchangeOnline
[[-ConnectionUri] <String>]
[[-AzureADAuthorizationEndpointUri] <String>]
[[-ExchangeEnvironmentName] <ExchangeEnvironment>]
[[-PSSessionOption] <PSSessionOption>]
[[-DelegatedOrganization] <String>]
[[-Prefix] <String>]
[[-CommandName] <String[]>]
[[-FormatTypeName] <String[]>]
[-AccessToken <String>]
[-AppId <String>]
[-BypassMailboxAnchoring]
[-Certificate <X509Certificate2>]
[-CertificateFilePath <String>]
[-CertificatePassword <SecureString>]
[-CertificateThumbprint <String>]
[-Credential <PSCredential>]
[-Device]
[-DisableWAM]
[-EnableErrorReporting]
[-EXOModuleBasePath <String>]
[-InlineCredential]
[-LoadCmdletHelp]
[-LogDirectoryPath <String>]
[-LogLevel <LogLevel>]
[-ManagedIdentity]
[-ManagedIdentityAccountId <String>]
[-Organization <String>]
[-PageSize <UInt32>]
[-ShowBanner]
[-ShowProgress <Boolean>]
[-SigningCertificate <X509Certificate2>]
[-SkipLoadingCmdletHelp]
[-SkipLoadingFormatData]
[-TrackPerformance <Boolean>]
[-UseMultithreading <Boolean>]
[-UserPrincipalName <String>]
[-UseRPSSession]
[<CommonParameters>]
Descrizione
Questo cmdlet crea una connessione di PowerShell all'organizzazione Exchange Online.
È probabile che i comandi connect non riescano se il percorso del profilo dell'account usato per la connessione contiene caratteri di PowerShell speciali , $ad esempio . La soluzione alternativa consiste nel connettersi usando un account diverso che non include caratteri speciali nel percorso del profilo.
Esempio
Esempio 1
Connect-ExchangeOnline -UserPrincipalName chris@contoso.com
Questo esempio si connette a Exchange Online PowerShell usando l'autenticazione moderna, con o senza autenticazione a più fattori. La connessione usa la modalità API REST e non richiede l'abilitazione dell'autenticazione di base in WinRM nel computer locale.
Esempio 2
Connect-ExchangeOnline -AppId <%App_id%> -CertificateThumbprint <%Thumbprint string of certificate%> -Organization "contoso.onmicrosoft.com"
Questo esempio si connette a Exchange Online PowerShell in uno scenario di scripting automatico usando un'identificazione personale del certificato.
Esempio 3
Connect-ExchangeOnline -AppId <%App_id%> -Certificate <%X509Certificate2 object%> -Organization "contoso.onmicrosoft.com"
Questo esempio si connette a Exchange Online PowerShell in uno scenario di scripting automatico usando un file di certificato. Questo metodo è particolarmente adatto per scenari in cui il certificato viene archiviato in computer remoti e recuperato in fase di esecuzione. Ad esempio, il certificato viene archiviato nel Azure Key Vault.
Esempio 4
Connect-ExchangeOnline -Device
In PowerShell 7.0.3 o versioni successive con la versione 2.0.4 o successiva del modulo, questo esempio si connette a Exchange Online PowerShell in scenari di script interattivi in computer che non dispongono di Web browser.
Il comando restituisce un URL e un codice univoco associato alla sessione. È necessario aprire l'URL in un browser in qualsiasi computer e immettere il codice univoco. Dopo aver completato l'accesso nel Web browser, la sessione nella finestra di PowerShell 7 viene autenticata tramite il normale flusso di autenticazione Microsoft Entra e i cmdlet Exchange Online vengono importati dopo pochi secondi.
Esempio 6
Connect-ExchangeOnline -InlineCredential
In PowerShell 7.0.3 o versioni successive con la versione 2.0.4 o successiva del modulo, questo esempio si connette a Exchange Online PowerShell in scenari di script interattivi passando le credenziali direttamente nella finestra di PowerShell.
Parametri
-AccessToken
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione del modulo 3.1.0-Preview1 o successiva.
Il parametro AccessToken specifica il token Web JSON (JWT) OAuth usato per connettersi a Exchange Online.
A seconda del tipo di token di accesso, è necessario usare questo parametro con i parametri Organization, DelegatedOrganization o UserPrincipalName.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AppId
Applicabile: Exchange Online
Il parametro AppId specifica l'ID applicazione dell'entità servizio usata nell'autenticazione basata su certificato. Un valore valido è il GUID dell'ID applicazione (entità servizio). Ad esempio, 36ee4c6c-0812-40a2-b820-b22ebd02bce3.
Per altre informazioni, vedere Autenticazione solo app per script automatici nel modulo Exchange Online PowerShell.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AzureADAuthorizationEndpointUri
Applicabile: Exchange Online
Nota: se si usa il parametro ExchangeEnvironmentName, non è necessario usare i parametri AzureADAuthorizationEndpointUri o ConnectionUri.
Il parametro AzureADAuthorizationEndpointUri specifica l'endpoint di autorizzazione Microsoft Entra che può emettere token di accesso OAuth2. Sono supportati i seguenti Exchange Online ambienti PowerShell e i valori correlati:
- Microsoft 365 o Microsoft 365 GCC: non usare questo parametro. Il valore richiesto è
https://login.microsoftonline.com/organizations, ma è anche il valore predefinito, quindi non è necessario usare questo parametro. - Office 365 Germania:
https://login.microsoftonline.de/organizations - Microsoft 365 GCC High o Microsoft 365 DoD:
https://login.microsoftonline.us/organizations
Il valore URI che termina in /organizations consente solo gli account aziendali o dell'istituto di istruzione. Il valore URI precedente che termina con /common funziona ancora, ma potrebbe richiedere di scegliere tra un account personale e un account aziendale o dell'istituto di istruzione. È consigliabile usare il /organizations valore URI negli scenari aziendali in cui gli account consumer devono essere esclusi.
Se si usa il parametro UserPrincipalName, non è necessario usare il parametro AzureADAuthorizationEndpointUri per gli utenti MFA o federati in ambienti che normalmente lo richiedono (è necessario UserPrincipalName o AzureADAuthorizationEndpointUri; OK per usare entrambi).
Nota: l'autenticazione MFA o l'autenticazione federata non è disponibile in Office 365 gestito da 21Vianet.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-BypassMailboxAnchoring
Applicabile: Exchange Online
L'opzione BypassMailboxAnchoring ignora l'uso dell'hint di ancoraggio della cassetta postale. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Certificate
Applicabile: Exchange Online
Il parametro Certificate consente di specificare il certificato usato per l'autenticazione basata su certificati.The Certificate parameter specifies the certificate that's used for certificate-based authentication (CBA). Un valore valido è il valore dell'oggetto X509Certificate2 del certificato.
Non usare questo parametro con i parametri CertificateFilePath o CertificateThumbprint.
Per altre informazioni su CBA, vedere Autenticazione solo app per script automatici nel modulo Exchange Online PowerShell.
Proprietà dei parametri
| Tipo: | X509Certificate2 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CertificateFilePath
Applicabile: Exchange Online
Il parametro CertificateFilePath consente di specificare il certificato usato per CBA. Un valore valido è il percorso pubblico completo del file di certificato. Usare il parametro CertificatePassword con questo parametro.
Non usare questo parametro con i parametri Certificate o CertificateThumbprint.
Per altre informazioni su CBA, vedere Autenticazione solo app per script automatici nel modulo Exchange Online PowerShell.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CertificatePassword
Applicabile: Exchange Online
Il parametro CertificatePassword consente di specificare la password necessaria per aprire il file del certificato quando si usa il parametro CertificateFilePath per identificare il certificato usato per CBA.
È possibile usare i metodi seguenti come valore per questo parametro:
-
(ConvertTo-SecureString -String '<password>' -AsPlainText -Force). - Prima di eseguire questo comando, archiviare la password come variabile , ad esempio ,
$password = Read-Host "Enter password" -AsSecureStringe quindi usare la variabile ($password) per il valore . -
(Get-Credential).passwordper richiedere di immettere la password in modo sicuro quando si esegue questo comando.
Per altre informazioni su CBA, vedere Autenticazione solo app per script automatici nel modulo Exchange Online PowerShell.
Nota: l'uso di un comando ConvertTo-SecureString per archiviare la password del certificato in locale elimina lo scopo di un metodo di connessione sicuro per gli scenari di automazione. L'uso di un comando Get-Credential per richiedere la password del certificato in modo sicuro non è ideale per gli scenari di automazione. In altre parole, non esiste un modo automatizzato e sicuro per connettersi usando un certificato locale.
Proprietà dei parametri
| Tipo: | SecureString |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CertificateThumbprint
Applicabile: Exchange Online
Il parametro CertificateThumbprint specifica il certificato usato per CBA. Un valore valido è il valore di identificazione personale del certificato. Ad esempio, 83213AEAC56D61C97AEE5C1528F4AC5EBA7321C1.
Non usare questo parametro con i parametri Certificate o CertificateFilePath.
Nota: il parametro CertificateThumbprint è supportato solo in Microsoft Windows.
Per altre informazioni su CBA, vedere Autenticazione solo app per script automatici nel modulo Exchange Online PowerShell.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CommandName
Applicabile: Exchange Online
Il parametro CommandName consente di specificare l'elenco delimitato da virgole dei comandi da importare nella sessione. Usare questo parametro per applicazioni o script che usano un set specifico di cmdlet. La riduzione del numero di cmdlet nella sessione consente di migliorare le prestazioni e ridurre il footprint di memoria dell'applicazione o dello script.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 6 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConnectionUri
Applicabile: Exchange Online
Nota: se si usa il parametro ExchangeEnvironmentName, non è necessario usare i parametri AzureADAuthorizationEndpointUri o ConnectionUri.
Il parametro ConnectionUri specifica l'endpoint di connessione per la sessione di PowerShell. Sono supportati i seguenti Exchange Online ambienti PowerShell e i valori correlati:
- Microsoft 365 o Microsoft 365 GCC: non usare questo parametro. Il valore richiesto è
https://outlook.office365.com/powershell-liveid/, ma è anche il valore predefinito, quindi non è necessario usare questo parametro. - Office 365 Germania:
https://outlook.office.de/PowerShell-LiveID - Office 365 gestito da 21Vianet:
https://partner.outlook.cn/PowerShell - Microsoft 365 GCC High:
https://outlook.office365.us/powershell-liveID - Microsoft 365 DoD:
https://webmail.apps.mil/powershell-liveID
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Credential
Applicabile: Exchange Online
Il parametro Credential consente di specificare il nome utente e la password usati per connettersi a Exchange Online PowerShell. In genere questo parametro viene utilizzato negli script o quando occorre fornire credenziali diverse con le autorizzazioni necessarie. Non usare questo parametro per gli account che usano l'autenticazione a più fattori (MFA).
Prima di eseguire il comando Connect-ExchangeOnline, archiviare il nome utente e la password in una variabile , $UserCredential = Get-Credentialad esempio . Usare quindi il nome della variabile ($UserCredential) per questo parametro.
Al termine del comando Connect-ExchangeOnline, la chiave della password nella variabile viene svuotata.
Per specificare la password per un file di certificato, non usare questo parametro. usare invece il parametro CertificatePassword.
Proprietà dei parametri
| Tipo: | PSCredential |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DelegatedOrganization
Applicabile: Exchange Online
Il parametro DelegatedOrganization consente di specificare l'organizzazione del cliente da gestire. Un valore valido per questo parametro è il dominio con estensione onmicrosoft.com primario o l'ID tenant dell'organizzazione del cliente.
Questo parametro funziona solo se l'organizzazione del cliente ha accettato la gestione delegata tramite il programma CSP.
Dopo aver eseguito correttamente l'autenticazione, i cmdlet in questa sessione vengono mappati all'organizzazione del cliente e tutte le operazioni in questa sessione vengono eseguite nell'organizzazione del cliente.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 4 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Device
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione 2.0.4-Preview6 o successiva del modulo e solo in PowerShell 7.
L'opzione Dispositivo viene in genere usata nei computer senza Web browser. Con questa opzione non è necessario specificare alcun valore.
Se si usa questa opzione, viene visualizzato un messaggio sullo schermo che contiene l'URL https://microsoft.com/devicelogin e un codice univoco. In qualsiasi altro dispositivo con un Web browser e un accesso a Internet aprire l'URL, immettere il codice univoco e immettere le credenziali nelle pagine successive.
Se l'accesso ha avuto esito positivo, la connessione di PowerShell continua.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DisableWAM
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione del modulo 3.7.2-Preview1 o successiva.
L'opzione DisableWAM disabilita Web Account Manager (WAM). Con questa opzione non è necessario specificare alcun valore.
A partire dalla versione 3.7.0, WAM è abilitato per impostazione predefinita durante la connessione a Exchange Online. Se si verificano problemi relativi a WAM durante l'accesso, è possibile usare questa opzione per disabilitare WAM.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-EnableErrorReporting
Applicabile: Exchange Online
L'opzione EnableErrorReporting specifica se abilitare la segnalazione errori. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ExchangeEnvironmentName
Applicabile: Exchange Online
ExchangeEnvironmentName specifica l'ambiente Exchange Online ed elimina la necessità di usare i parametri AzureADAuthorizationEndpointUri e ConnectionUri. Sono supportati gli ambienti powershell Exchange Online seguenti:
- Microsoft 365 o Microsoft 365 GCC: non usare questo parametro. Il valore richiesto è
O365Default, ma è anche il valore predefinito, quindi non è necessario usare questo parametro. - Office 365 Germania:
O365GermanyCloud - Office 365 gestito da 21Vianet:
O365China - Microsoft 365 GCC High:
O365USGovGCCHigh - Microsoft 365 DoD:
O365USGovDoD
Proprietà dei parametri
| Tipo: | ExchangeEnvironment |
| Valore predefinito: | O365Default |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 2 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-EXOModuleBasePath
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione del modulo 3.9.1-Preview1 o successiva.
Il parametro EXOModuleBasePath specifica la cartella in cui è archiviata la copia temporanea locale del modulo Exchange Online PowerShell. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Connect-ExchangeOnline comandi archivia una copia temporanea del modulo Exchange Online in locale nel client per la connettività della sessione. Per impostazione predefinita, la copia temporanea del modulo viene archiviata nella cartella %TMP% (per impostazione predefinita, C:\Users\<UserName>\AppData\Local\Temp).
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-FormatTypeName
Applicabile: Exchange Online
Il parametro FormatTypeName specifica il formato di output del cmdlet.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 7 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-InlineCredential
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione 2.0.4-Preview6 o successiva del modulo e solo in PowerShell 7.
L'opzione InlineCredential specifica se passare le credenziali direttamente nella finestra Windows PowerShell. Con questa opzione non è necessario specificare alcun valore.
Questa opzione è simile al parametro Credential, ma con maggiore sicurezza. L'opzione InlineCredential non richiede l'archiviazione delle credenziali in locale nello script ed è possibile immettere le credenziali direttamente in una sessione interattiva di PowerShell.
Questa opzione non funziona con gli account che usano MFA.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-LoadCmdletHelp
Applicabile: Exchange Online
Nota: questo parametro è disponibile nel modulo versione 3.7.0-Preview1 o successiva.
L'opzione LoadCmdletHelp scarica i file della Guida del cmdlet per il cmdlet Get-Help nelle connessioni API REST. Con questa opzione non è necessario specificare alcun valore.
A partire dalla versione 3.7.0-Preview1, i file della Guida per la riga di comando non vengono scaricati per impostazione predefinita. Usare questa opzione per scaricare i file per la Guida dei cmdlet nella riga di comando.
Suggerimento: questo parametro sostituisce il parametro SkipLoadingCmdletHelp. Il parametro SkipLoadingCmdletHelp non è più necessario e non funziona più, perché i file della Guida dei cmdlet non vengono più scaricati per impostazione predefinita.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-LogDirectoryPath
Applicabile: Exchange Online
Il parametro LogDirectoryPath consente di specificare il percorso dei file di log. Il percorso predefinito è %TMP%\EXOCmdletTelemetry\EXOCmdletTelemetry-yyyymmdd-hhmmss.csv.
Se si specifica un percorso personalizzato e un nome file che contiene spazi, racchiudere il valore tra virgolette (").
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-LogLevel
Applicabile: Exchange Online
Il parametro LogLevel specifica il livello di registrazione. I valori validi sono Default e All.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ManagedIdentity
Applicabile: Exchange Online
L'opzione ManagedIdentity specifica che si usa l'identità gestita per connettersi. Con questa opzione non è necessario specificare alcun valore.
Le connessioni alle identità gestite sono attualmente supportate per i tipi di risorse Azure seguenti:
- runbook Automazione di Azure
- macchine virtuali di Azure
- Azure set di scalabilità di macchine virtuali
- Funzioni di Azure
È necessario usare questa opzione con il parametro Organization.
Per l'identità gestita assegnata dall'utente, è necessario usare anche questa opzione con il parametro ManagedIdentityAccountId.
Per altre informazioni sulla connessione con l'identità gestita, vedere Usare le identità gestite Azure per connettersi a Exchange Online PowerShell.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ManagedIdentityAccountId
Applicabile: Exchange Online
Il parametro ManagedIdentityAccountId specifica l'identità gestita assegnata dall'utente che si sta usando per connettersi. Un valore valido per questo parametro è l'ID applicazione (GUID) dell'entità servizio che corrisponde all'identità gestita assegnata dall'utente in Azure.
È necessario usare questo parametro con il parametro Organization e l'opzione ManagedIdentity.
Per altre informazioni sulla connessione con l'identità gestita, vedere Usare le identità gestite Azure per connettersi a Exchange Online PowerShell.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Organization
Applicabile: Exchange Online
Il parametro Organization consente di specificare l'organizzazione quando ci si connette tramite CBA o identità gestita. Un valore valido per questo parametro è il dominio con estensione onmicrosoft.com primario o l'ID tenant dell'organizzazione.
Per altre informazioni sulla connessione con CBA, vedere Autenticazione solo app per script automatici nel modulo Exchange Online PowerShell.
Per altre informazioni sulla connessione con l'identità gestita, vedere Usare le identità gestite Azure per connettersi a Exchange Online PowerShell.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PageSize
Applicabile: Exchange Online
Il parametro PageSize consente di specificare il numero massimo di voci per pagina. I valori validi per questo parametro sono i numeri interi compresi tra 1 e 1000. Il valore predefinito è 1000.
Proprietà dei parametri
| Tipo: | UInt32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Prefix
Applicabile: Exchange Online
Il parametro Prefix specifica un valore di testo da aggiungere ai nomi dei cmdlet di PowerShell Exchange Online quando ci si connette. Ad esempio, Get-InboundConnector diventa Get-ContosoInboundConnector quando si usa il valore Contoso per questo parametro.
- Il valore Prefix non può contenere spazi o caratteri speciali come caratteri di sottolineatura o asterischi.
- Non è possibile usare il valore Prefisso EXO. Tale valore è riservato ai nove cmdlet Get-EXO* esclusivi incorporati nel modulo.
- Il parametro Prefix influisce solo sui nomi di cmdlet Exchange Online importati. Non influisce sui nomi dei cmdlet incorporati nel modulo , ad esempio Disconnect-ExchangeOnline.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 5 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PSSessionOption
Applicabile: Exchange Online
Nota: questo parametro non funziona nelle connessioni API REST.
Il parametro PSSessionOption consente di specificare le opzioni di sessione di PowerShell da usare nella connessione a Exchange Online. Questo parametro funziona solo se si usa anche l'opzione UseRPSSession nello stesso comando.
Archiviare l'output del comando New-PSSessionOption in una variabile , ad esempio , $PSOptions = New-PSSessionOption <Settings>e usare il nome della variabile come valore per questo parametro , $PSOptionsad esempio .
Proprietà dei parametri
| Tipo: | PSSessionOption |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 3 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ShowBanner
Applicabile: Exchange Online
L'opzione ShowBanner mostra o nasconde il messaggio banner visualizzato quando si esegue Connect-ExchangeOnline. Con questa opzione non è necessario specificare alcun valore.
- Per visualizzare il banner, non è necessario usare questa opzione (il banner viene visualizzato per impostazione predefinita).
- Per nascondere il banner, usare questa sintassi esatta:
-ShowBanner:$false.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | $true |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ShowProgress
Applicabile: Exchange Online
Il parametro ShowProgress consente di specificare se visualizzare o nascondere l'indicatore di stato dei cmdlet importati durante la connessione. I valori validi sono:
- $true: viene visualizzata la barra di stato. Questo valore è il valore predefinito.
- $false: attualmente questo valore non ha alcun effetto.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SigningCertificate
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione 3.2.0-Preview4 o successiva del modulo.
Il parametro SigningCertificate specifica il certificato client usato per firmare i file di formato (*. Format.ps1xml) o file di modulo script (con estensione psm1) nel modulo temporaneo creato Connect-ExchangeOnline.
Un valore valido per questo parametro è una variabile che contiene il certificato o un comando o un'espressione che ottiene il certificato.
Per trovare il certificato, usare il cmdlet Get-PfxCertificate nel modulo Microsoft.PowerShell.Security oppure usare il cmdlet Get-ChildItem nell'unità certificato (Cert:). Se il certificato non è valido o non ha un'autorità sufficiente, il comando avrà esito negativo.
Proprietà dei parametri
| Tipo: | X509Certificate2 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SkipLoadingCmdletHelp
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione del modulo 3.3.0-Preview1 o successiva.
Nella versione 3.7.0-Preview1 o successiva, questo parametro viene sostituito dal parametro LoadCmdletHelp. Il parametro SkipLoadingCmdletHelp non è più necessario e non esegue più alcuna operazione, perché i file della Guida dei cmdlet non vengono più scaricati per impostazione predefinita.
L'opzione SkipLoadingCmdletHelp impedisce il download dei file della Guida del cmdlet per il cmdlet Get-Help nelle connessioni API REST. Con questa opzione non è necessario specificare alcun valore.
Quando si usa questa opzione, non si ottengono file della Guida locali per alcun cmdlet dalla riga di comando.
Questa opzione non funziona con l'opzione UseRPSSession.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SkipLoadingFormatData
Applicabile: Exchange Online
L'opzione SkipLoadingFormatData impedisce il download dei dati di formato per le connessioni API REST. Con questa opzione non è necessario specificare alcun valore.
Quando si usa questa opzione, l'output di qualsiasi cmdlet di Exchange non viene formattato.
Usare questa opzione per evitare errori durante la connessione a Exchange Online PowerShell dall'interno di un servizio Windows o dell'SDK Windows PowerShell.
Questa opzione non funziona con l'opzione UseRPSSession.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-TrackPerformance
Applicabile: Exchange Online
Il parametro TrackPerformance misura eventi aggiuntivi, ad esempio il carico della CPU e la memoria utilizzata. I valori validi sono:
- $true: il rilevamento delle prestazioni è abilitato.
- $false: il rilevamento delle prestazioni è disabilitato. Questo valore è il valore predefinito.
Questo parametro funziona solo quando la registrazione è abilitata.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-UseMultithreading
Applicabile: Exchange Online
Il parametro UseMultithreading specifica se disabilitare o abilitare il multithreading nel modulo Exchange Online PowerShell. I valori validi sono:
- $true: abilitare il multithreading. Questo valore è il valore predefinito.
- $false: disabilitare il multithreading. Questo valore peggiora le prestazioni dei nove cmdlet Get-EXO* esclusivi nel modulo.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-UserPrincipalName
Applicabile: Exchange Online
Il parametro UserPrincipalName consente di specificare l'account che si vuole usare per la connessione, navin@contoso.onmicrosoft.comad esempio . L'uso di questo parametro consente di ignorare l'immissione di un nome utente nel prompt delle credenziali di autenticazione moderna (viene richiesto di immettere una password).
Se si usa il parametro UserPrincipalName, non è necessario usare il parametro AzureADAuthorizationEndpointUri per gli utenti MFA o federati in ambienti che normalmente lo richiedono (è necessario UserPrincipalName o AzureADAuthorizationEndpointUri; OK per usare entrambi).
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-UseRPSSession
Applicabile: Exchange Online
Nota: le connessioni remote di PowerShell a Exchange Online PowerShell sono deprecate. Per altre informazioni, vedere Deprecation of Remote PowerShell in Exchange Online.For more information, see Deprecation of Remote PowerShell in Exchange Online.
L'opzione UseRPSSession consente di connettersi a Exchange Online PowerShell usando l'accesso remoto di PowerShell tradizionale a tutti i cmdlet. Con questa opzione non è necessario specificare alcun valore.
Se non si usa questa opzione, viene usata la modalità API REST per la connessione, quindi l'autenticazione di base in WinRM non è necessaria.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| 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.