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 connettersi a Exchange Online PowerShell o a PowerShell autonomo Exchange Online Protection usando l'autenticazione moderna. 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
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]
[-EnableErrorReporting]
[-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.comQuesto 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 Key Vault di Azure.
Esempio 4
Connect-ExchangeOnline -DeviceIn 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 -InlineCredentialIn 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
Nota: questo parametro è disponibile nella versione 3.1.0 o successiva del modulo.
Il parametro AccessToken specifica il token Web JSON (JWT) OAuth usato per connettersi a ExchangeOnline.
A seconda del tipo di token di accesso, è necessario usare questo parametro con il parametro Organization, DelegatedOrganization o UserPrincipalName.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-AppId
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.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-AzureADAuthorizationEndpointUri
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/common, ma è anche il valore predefinito, quindi non è necessario usare questo parametro. - Office 365 Germania:
https://login.microsoftonline.de/common - Microsoft 365 GCC High o Microsoft 365 DoD:
https://login.microsoftonline.us/common
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.
| Tipo: | String |
| Posizione: | 1 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-BypassMailboxAnchoring
L'opzione BypassMailboxAnchoring ignora l'uso dell'hint di ancoraggio della cassetta postale. Con questa opzione non è necessario specificare alcun valore.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-Certificate
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.
| Tipo: | X509Certificate2 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-CertificateFilePath
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.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-CertificatePassword
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.
| Tipo: | SecureString |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-CertificateThumbprint
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.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-CommandName
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.
| Tipo: | String[] |
| Posizione: | 6 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-ConnectionUri
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
| Tipo: | String |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-Credential
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.
| Tipo: | PSCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-DelegatedOrganization
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.
| Tipo: | String |
| Posizione: | 4 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-Device
Nota: questo parametro è disponibile nella versione 2.0.4 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.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-EnableErrorReporting
L'opzione EnableErrorReporting specifica se abilitare la segnalazione errori. Con questa opzione non è necessario specificare alcun valore.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-ExchangeEnvironmentName
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
| Tipo: | ExchangeEnvironment |
| Posizione: | 2 |
| Valore predefinito: | O365Default |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-FormatTypeName
Il parametro FormatTypeName specifica il formato di output del cmdlet.
| Tipo: | String[] |
| Posizione: | 7 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-InlineCredential
Nota: questo parametro è disponibile nella versione 2.0.4 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.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-LoadCmdletHelp
Nota: questo parametro è disponibile nella versione 3.7.0-Preview1 o successiva del modulo.
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.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-LogDirectoryPath
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 (").
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-LogLevel
Il parametro LogLevel specifica il livello di registrazione. I valori validi sono Default e All.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-ManagedIdentity
L'opzione ManagedIdentity specifica che si usa l'identità gestita per connettersi. Con questa opzione non è necessario specificare alcun valore.
Le connessioni di identità gestite sono attualmente supportate per i tipi di risorse di 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 identità gestita, vedere Usare le identità gestite di Azure per connettersi a Exchange Online PowerShell.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-ManagedIdentityAccountId
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 identità gestita, vedere Usare le identità gestite di Azure per connettersi a Exchange Online PowerShell.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-Organization
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 identità gestita, vedere Usare le identità gestite di Azure per connettersi a Exchange Online PowerShell.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-PageSize
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.
| Tipo: | UInt32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-Prefix
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.
| Tipo: | String |
| Posizione: | 5 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-PSSessionOption
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 .
| Tipo: | PSSessionOption |
| Posizione: | 3 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-ShowBanner
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.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | $true |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-ShowProgress
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 è il valore predefinito.
- $false: attualmente questo valore non ha alcun effetto.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-SigningCertificate
Nota: questo parametro è disponibile nella versione 3.2.0 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.
| Tipo: | X509Certificate2 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-SkipLoadingCmdletHelp
Nota: questo parametro è disponibile nella versione 3.3.0 o successiva del modulo.
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. Alla fine, questo parametro verrà ritirato, quindi rimuoverlo da qualsiasi script.
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.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-SkipLoadingFormatData
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 verrà 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.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-TrackPerformance
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 è il valore predefinito.
Questo parametro funziona solo quando la registrazione è abilitata.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-UseMultithreading
Il parametro UseMultithreading specifica se disabilitare o abilitare il multithreading nel modulo Exchange Online PowerShell. I valori validi sono:
- $true: abilitare il multithreading. Questo è il valore predefinito.
- $false: disabilitare il multithreading. Questo valore ridurrà le prestazioni dei nove cmdlet Get-EXO* esclusivi nel modulo.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-UserPrincipalName
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).
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-UseRPSSession
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.
Questa opzione richiede che l'autenticazione di base sia abilitata in WinRM nel computer locale. Per altre informazioni, vedere Attivare l'autenticazione di base in WinRM.
Se non si usa questa opzione, viene usata la modalità API REST per la connessione, quindi l'autenticazione di base in WinRM non è necessaria.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |