Connect-ExchangeOnline
Questo cmdlet è disponibile solo nel modulo PowerShell di Exchange Online. Per ulteriori informazioni, vedere Informazioni sul modulo PowerShell di Exchange Online.
Usare il cmdlet Connect-ExchangeOnline nel modulo Exchange Online PowerShell per usare l'autenticazione moderna per connettersi a PowerShell o PowerShell per Exchange Online componente aggiuntivo per la sicurezza predefinita per le cassette postali locali. Questo cmdlet funziona per gli account con o senza autenticazione a più fattori (MFA).
Per connettersi a PowerShell per la sicurezza & la conformità, 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 PowerShell all'organizzazione di Exchange Online.
I comandi di connessione avranno probabilmente esito negativo se il percorso del profilo dell'account utilizzato per la connessione contiene caratteri speciali di PowerShell, $ad esempio ). La soluzione alternativa consiste nel connettersi usando un account diverso che non contenga caratteri speciali nel percorso del profilo.
Esempio
Esempio 1
Connect-ExchangeOnline -UserPrincipalName chris@contoso.com
Questo esempio si connette a PowerShell di Exchange Online usando l'autenticazione moderna, con o senza autenticazione a più fattori (MFA). La connessione usa la modalità API REST e non richiede l'autenticazione di base per l'abilitazione 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 PowerShell di Exchange Online in uno scenario di esecuzione script automatica 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 PowerShell di Exchange Online in uno scenario di esecuzione script automatica usando un file di certificato. Questo metodo è più adatto per gli 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 versione successiva usando la versione 2.0.4 o successiva del modulo, questo esempio si connette a PowerShell di Exchange Online in scenari di script interattivi in computer che non hanno 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 di Microsoft Entra e i cmdlet di Exchange Online vengono importati dopo pochi secondi.
Esempio 6
Connect-ExchangeOnline -InlineCredential
In PowerShell 7.0.3 o versione successiva usando la versione 2.0.4 o successiva del modulo, questo esempio si connette a PowerShell di Exchange Online 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 consente di specificare il token Web JSON OAuth (JWT) utilizzato per connettersi a Exchange Online.
A seconda del tipo di token di accesso, è necessario utilizzare 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 consente di specificare l'ID applicazione dell'entità servizio utilizzata nell'autenticazione basata su certificati (CBA). 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 gli script automatici nel modulo PowerShell di Exchange Online.
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 consente di specificare l'endpoint di autorizzazione di Microsoft Entra che può rilasciare token di accesso OAuth2. Sono supportati i seguenti ambienti PowerShell di Exchange Online e i relativi valori:
- 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 con /organizations consente solo gli account aziendali o dell'istituto di istruzione. Il valore URI precedente che termina con /common funziona ancora, ma potrebbe essere richiesto 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 negli ambienti che normalmente lo richiedono (UserPrincipalName o AzureADAuthorizationEndpointUri è obbligatorio; 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 per l'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 utilizzato per l'autenticazione basata su certificati (CBA). Un valore valido è il valore dell'oggetto X509Certificate2 del certificato.
Non usare questo parametro con i parametri CertificateFilePath o CertificateThumbprint.
Per ulteriori informazioni sull'analisi contabile, vedere Autenticazione solo tramite app per script automatici nel modulo PowerShell di Exchange Online.
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 utilizzato per l'analisi 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 ulteriori informazioni sull'analisi contabile, vedere Autenticazione solo tramite app per script automatici nel modulo PowerShell di Exchange Online.
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 di certificato quando si usa il parametro CertificateFilePath per identificare il certificato usato per l'analisi CBA.
È possibile utilizzare i metodi seguenti come valore per questo parametro:
-
(ConvertTo-SecureString -String '<password>' -AsPlainText -Force). - Prima di eseguire questo comando, archivia la password come variabile (ad esempio,
$password = Read-Host "Enter password" -AsSecureString) e quindi usa la variabile ($password) per il valore. -
(Get-Credential).passwordper visualizzare la richiesta di immissione sicura della password quando si esegue questo comando.
Per ulteriori informazioni sull'analisi contabile, vedere Autenticazione solo tramite app per script automatici nel modulo PowerShell di Exchange Online.
Nota: l'uso di un comando ConvertTo-SecureString per archiviare la password del certificato in locale vanifica lo scopo di un metodo di connessione sicuro per gli scenari di automazione. L'uso sicuro di un comando Get-Credential per richiedere la password del certificato non è l'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 consente di specificare il certificato utilizzato per l'analisi contabile. Un valore valido è il valore dell'identificazione personale del certificato. Ad esempio, 83213AEAC56D61C97AEE5C1528F4AC5EBA7321C1.
Non utilizzare questo parametro con i parametri Certificate o CertificateFilePath.
Nota: il parametro CertificateThumbprint è supportato solo in Microsoft Windows.
Per ulteriori informazioni sull'analisi contabile, vedere Autenticazione solo tramite app per script automatici nel modulo PowerShell di Exchange Online.
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 specifica l'elenco di comandi separati da virgole da importare nella sessione. Usare questo parametro per le applicazioni o gli 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 consente di specificare l'endpoint di connessione per la sessione di PowerShell. Sono supportati i seguenti ambienti PowerShell di Exchange Online e i relativi valori:
- 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 utilizzati per connettersi a PowerShell per Exchange Online. In genere questo parametro viene utilizzato negli script o quando occorre fornire credenziali diverse con le autorizzazioni necessarie. Non utilizzare questo parametro per gli account che usano l'autenticazione a più fattori (MFA).
Prima di eseguire il comando Connect-ExchangeOnline, memorizzate il nome utente e la password in una variabile, $UserCredential = Get-Credentialad esempio ). Quindi, usa 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; utilizzare 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 che si desidera gestire. Un valore valido per questo parametro è l'ID tenant o dominio .onmicrosoft.com primario dell'organizzazione del cliente.
Questo parametro funziona solo se l'organizzazione del cliente ha accettato la gestione delegata tramite il programma CSP.
Dopo aver completato 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 del modulo 2.0.4-Preview6 o successiva e solo in PowerShell 7.
L'opzione Dispositivo viene in genere usata nei computer senza browser Web. Con questa opzione non è necessario specificare alcun valore.
Utilizzando questa opzione, viene visualizzato un messaggio sullo schermo contenente l'URL https://microsoft.com/devicelogin e un codice univoco. In qualsiasi altro dispositivo con un Web browser e accesso a Internet, aprire l'URL, immettere il codice univoco e immettere le credenziali nelle pagine successive.
Se l'accesso è stato eseguito correttamente, la connessione 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 Gestione account Web (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 correlati 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 consente di specificare se abilitare la segnalazione degli 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 di Exchange Online ed elimina la necessità di usare i parametri AzureADAuthorizationEndpointUri e ConnectionUri. Sono supportati i seguenti ambienti PowerShell di Exchange Online:
- 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 consente di specificare la cartella in cui è archiviata la copia temporanea locale del modulo PowerShell di Exchange Online. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Connect-ExchangeOnline comandi archiviano una copia temporanea del modulo Exchange Online localmente sul client per la connettività della sessione. Per impostazione predefinita, la copia temporanea del modulo è memorizzata 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 consente di specificare 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 del modulo 2.0.4-Preview6 o successiva e solo in PowerShell 7.
Il parametro InlineCredential consente di specificare se passare le credenziali direttamente nella finestra di Windows PowerShell. Con questa opzione non è necessario specificare alcun valore.
Questa opzione è simile al parametro Credential, ma con una sicurezza aggiuntiva. Il commutatore InlineCredential non richiede l'archiviazione delle credenziali in locale nello script ed è possibile immetterle direttamente in una sessione di PowerShell interattiva.
Questa opzione non funziona con gli account che usano l'autenticazione a più fattori.
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 nella versione del modulo 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 da v3.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 del cmdlet dalla 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 del 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 consente di specificare 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 la connessione. Con questa opzione non è necessario specificare alcun valore.
Le connessioni di identità gestita sono attualmente supportate per i tipi di risorse di Azure seguenti:
- Runbook di Automazione di Azure
- macchine virtuali di Azure
- Azure set di scalabilità di macchine virtuali
- Funzioni di Azure
È necessario utilizzare questo switch con il parametro Organization.
Per l'identità gestita assegnata dall'utente, è necessario utilizzare questa opzione anche con il parametro ManagedIdentityAccountId.
Per altre informazioni sulla connessione con l'identità gestita, vedere Usare le identità gestite di Azure per connettersi a PowerShell per Exchange Online.
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 consente di specificare 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 utilizzare questo parametro con il parametro Organization e l'opzione ManagedIdentity.
Per altre informazioni sulla connessione con l'identità gestita, vedere Usare le identità gestite di Azure per connettersi a PowerShell per Exchange Online.
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 l'account CBA o l'identità gestita. Un valore valido per questo parametro è il dominio .onmicrosoft.com primario dell'organizzazione.
Per altre informazioni sulla connessione con CBA, vedere Autenticazione solo app per script automatici nel modulo PowerShell di Exchange Online.
Per altre informazioni sulla connessione con l'identità gestita, vedere Usare le identità gestite di Azure per connettersi a PowerShell per Exchange Online.
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 consente di specificare un valore di testo da aggiungere ai nomi dei cmdlet di PowerShell per Exchange Online al momento della connessione. Ad esempio, Get-InboundConnector diventa Get-ContosoInboundConnector quando si usa il valore Contoso per questo parametro.
- Il valore del prefisso non può contenere spazi o caratteri speciali come caratteri di sottolineatura o asterischi.
- Non è possibile utilizzare il valore del prefisso EXO. Tale valore è riservato per i nove cmdlet Get-EXO* esclusivi incorporati nel modulo.
- Il parametro Prefix influisce solo sui nomi dei cmdlet di 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 della sessione PowerShell da utilizzare nella connessione a Exchange Online. Questo parametro funziona solo se si utilizza anche l'opzione UseRPSSession nello stesso comando.
Memorizzate l'output del comando New-PSSessionOption in una variabile (ad esempio, $PSOptions = New-PSSessionOption <Settings>) e utilizzate il nome della variabile come valore per questo parametro (ad esempio, $PSOptions).
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 al momento della connessione. I valori validi sono:
- $true: viene visualizzato l'indicatore di stato. Questo è il valore predefinito.
- $false: Attualmente, questo valore non ha effetti.
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 del modulo 3.2.0-Preview4 o successiva.
Il parametro SigningCertificate consente di specificare il certificato client utilizzato per firmare i file di formato (*. Format.ps1xml) o file del modulo di script (.psm1) nel modulo temporaneo creato Connect-ExchangeOnline.
Un valore valido per questo parametro è una variabile che contiene il certificato oppure un comando o un'espressione che ottiene il certificato.
Per trovare il certificato, usare il cmdlet Get-PfxCertificate nel modulo Microsoft.PowerShell.Security o usare il cmdlet Get-ChildItem nell'unità certificato (Cert:). Se il certificato non è valido o non ha l'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 è sostituito dal parametro LoadCmdletHelp. Il parametro SkipLoadingCmdletHelp non è più necessario e non esegue più alcuna operazione, perché i file della Guida del 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 i file della Guida locale per alcun cmdlet nella 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 è formattato.
Usare questa opzione per evitare errori durante la connessione a Exchange Online PowerShell da un servizio Windows o da Windows PowerShell SDK.
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 monitoraggio delle prestazioni è abilitato.
- $false: il monitoraggio delle prestazioni è disabilitato. Questo è 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 consente di specificare se disabilitare o abilitare il multithreading nel modulo PowerShell di Exchange Online. I valori validi sono:
- $true: abilita il multi-threading. Questo è il valore predefinito.
- $false: disabilitare il multithreading. Questo valore riduce 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 desidera utilizzare 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 negli ambienti che normalmente lo richiedono (UserPrincipalName o AzureADAuthorizationEndpointUri è obbligatorio; 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: questo parametro è deprecato nella versione del modulo 3.9.2 o successiva. Le connessioni API REST hanno sostituito le connessioni PowerShell remote in PowerShell di Exchange Online nel mese di ottobre 2023. Per altre informazioni, vedere Deprecazione di PowerShell remoto in Exchange Online.
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.