連線至 Exchange Online PowerShell

Exchange Online PowerShell V2 模組(縮寫為 EXO V2 模組)使用新式驗證,可與多重要素驗證(MFA)搭配使用,以連線到 Microsoft 365 中的所有 Exchange 相關 PowerShell 環境: Exchange Online PowerShell、安全性與合規性 PowerShell,以及獨立 Exchange Online Protection (EOP) PowerShell。 如需 EXO V2 模組的詳細資訊,請參閱Exchange Online PowerShell V2 模組相關資訊

本主題包含如何使用 EXO V2 模組 (搭配或不搭配 MFA),連線到 Exchange Online PowerShell 的指示。

若要使用 終將被棄用的較不安全的舊版遠端 PowerShell 連線指示,請參閱 基本驗證-連線到 Exchange Online PowerShell

如需使用較舊版 Exchange Online 遠端 PowerShell 模組,透過多重要素驗證,連線至 Exchange Online PowerShell,請參閱V1模組 - 使用多重要素驗證連線至 Exchange Online PowerShell。 請注意,此舊版模組終將失效。

開始之前有哪些須知?

  • 安裝和使用 EXO V2 模組的需求,請參閱 安裝及維護 EXO V2 模組。 此主題中的其餘指示皆假設您已安裝該模組。

  • 如果您的組織是內部部署 Exchange,且有搭配 Exchange Online Protection (EOP) 服務授權的 Exchange Enterprise CAL,則您的 EOP PowerShell 連線指示會與 Exchange Online PowerShell 相同,如此主題所述。

Tip

有問題嗎? 在 Exchange Online 討論區中提問。

使用 MFA 和新式驗證連線至 Exchange Online PowerShell

如果您的帳戶使用多重要素驗證,請使用本節所述的步驟。 否則,請跳至 使用新式驗證,連線到 Exchange Online PowerShell 一節。

  1. 在 Windows PowerShell 視窗中,執行下列命令來載入 EXO V2 模組:

    Import-Module ExchangeOnlineManagement
    

    附註:如果您已 安裝 EXO V2 模組,則先前的命令可如其編寫方式運作。

  2. 您需要執行的命令會使用下列語法:

    Connect-ExchangeOnline -UserPrincipalName <UPN> -ShowProgress $true [-ExchangeEnvironmentName <Value>] [-DelegatedOrganization <String>] [-PSSessionOption $ProxyOptions]
    
    • <UPN> 是以使用者主體名稱格式(例如 navin@contoso.com)表示的您的帳戶。
    • 當您使用 ExchangeEnvironmentName 參數時,不需要使用 ConnectionUriAzureADAuthorizationEndPointUrl 參數。 如需詳細資訊,請參閱 Connect-ExchangeOnline 中的參數描述。
    • DelegatedOrganization 參數指定您要以授權的 Microsoft 合作夥伴的身份來管理的客戶組織。 如需詳細資訊,請參閱 合作夥伴
    • 如果您在 Proxy 伺服器背後,請先執行下列命令:$ProxyOptions = New-PSSessionOption -ProxyAccessType <Value>,其中的 <Value> 是 IEConfigWinHttpConfigAutoDetect。 然後,使用 PSSessionOption 參數搭配值 $ProxyOptions。 如需詳細資訊,請參閱 New-PSSessionOption

    此範例會連線至 Microsoft 365 或 Microsoft 365 GCC 組織 中的 Exchange Online PowerShell:

    Connect-ExchangeOnline -UserPrincipalName navin@contoso.com -ShowProgress $true
    

    此範例會連線至Office 365 德國組織中的 Exchange Online PowerShell

    Connect-ExchangeOnline -UserPrincipalName lukas@fabrikam.de -ShowProgress $true -ExchangeEnvironmentName O365GermanyCloud
    

    此範例會連線至 Microsoft GCC High 組織中的 Exchange Online PowerShell

    Connect-ExchangeOnline -UserPrincipalName laura@blueyonderairlines.us -ShowProgress $true -ExchangeEnvironmentName O365USGovGCCHigh
    

    此範例會連線至 Microsoft 365 DoD 組織中的 Exchange Online PowerShell

    Connect-ExchangeOnline -UserPrincipalName julia@adatum.mil -ShowProgress $true -ExchangeEnvironmentName O365USGovDoD
    

    此範例會連線至 Exchange Online PowerShell 以管理其他租使用者

    Connect-ExchangeOnline -UserPrincipalName navin@contoso.com -ShowProgress $true -DelegatedOrganization adatum.onmicrosoft.com
    

如需詳細的語法和參數資訊,請參閱 Connect-ExchangeOnline

Note

完成時,請務必中斷遠端 PowerShell 工作階段連線。如果未先中斷工作階段連線即關閉 Windows PowerShell 視窗,您可能會用完您可以使用的所有遠端 PowerShell 工作階段,而需要等待這些工作階段到期。若要中斷遠端 PowerShell 工作階段連線,請執行下列命令。

Disconnect-ExchangeOnline

使用新式驗證連線至 Exchange Online PowerShell

如果您的帳戶未使用多重要素驗證,請使用本節所述的步驟。

  1. 在 Windows PowerShell 視窗中,執行下列命令來載入 EXO V2 模組:

    Import-Module ExchangeOnlineManagement
    

    附註:如果您已 安裝 EXO V2 模組,則先前的命令可如其編寫方式運作。

  2. 執行下列命令:

    Note

    執行 Connect-ExchangeOnline 命令後,在提示輸入使用者名稱和密碼的下一步,您可以跳過此步驟並省略 Credential 參數。 如果在下一步中省略 Credential 參數並包含 UserPrincipalName 參數,則只有在執行 Connect-ExchangeOnline 命令後才會提示您輸入密碼。

    $UserCredential = Get-Credential
    

    在隨即出現的 [Windows PowerShell 認證要求] 對話方塊中,輸入您的公司或學校帳戶和密碼,然後按一下 [確定]

  3. 您需要執行的最後一個命令會使用以下語法:

    Connect-ExchangeOnline [-Credential $UserCredential] -ShowProgress $true [-ShowBanner:$false] [-ExchangeEnvironmentName <Value>] [-DelegatedOrganization <String>] [-PSSessionOption $ProxyOptions]
    
    • 當您使用 ExchangeEnvironmentName 參數時,不需要使用 ConnectionUriAzureADAuthorizationEndPointUrl 參數。 如需詳細資訊,請參閱 Connect-ExchangeOnline 中的參數描述。
    • DelegatedOrganization 參數指定您要以授權的 Microsoft 合作夥伴的身份來管理的客戶組織。 如需詳細資訊,請參閱 合作夥伴
    • 如果您在 Proxy 伺服器後面,請將 New-PSSessionOption cmdlet 的輸出儲存在變數中 (例如,$ProxyOptions = New-PSSessionOption -ProxyAccessType <Value> [-ProxyAuthentication <Value>] [-ProxyCredential <Value>])。 然後,使用變數 ($ProxyOptions) 做為 PSSessionOption 參數的值。

    連線至 Microsoft 365 或 Microsoft 365 GCC 組織中的 Exchange Online PowerShell

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true
    

    連線至Office 365 德國組織中的 Exchange Online PowerShell

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true -ExchangeEnvironmentName O365GermanyCloud
    

    連線至由 21Vianet 運作的 Office 365 組織中的 Exchange Online PowerShell

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true -ExchangeEnvironmentName O365China
    

    連線至 Microsoft 365 GCC High 組織中的 Exchange Online PowerShell

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true -ExchangeEnvironmentName O365USGovGCCHigh
    

    連線至 Microsoft 365 DoD 組織中的 Exchange Online PowerShell

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true -ExchangeEnvironmentName O365USGovDoD
    

如需詳細的語法和參數資訊,請參閱 Connect-ExchangeOnline

Note

完成時,請務必中斷遠端 PowerShell 工作階段連線。 如果未先中斷工作階段連線即關閉 Windows PowerShell 視窗,您可能會用完您可以使用的所有遠端 PowerShell 工作階段,而需要等待這些工作階段到期。 若要中斷遠端 PowerShell 工作階段的連線,請執行下列命令:

Disconnect-ExchangeOnline

如何知道這是否正常運作?

Exchange Online Cmdlet 會匯入您的本機 Windows PowerShell 工作階段中,且會有進度列追蹤此作業。 如果您未收到任何錯誤,便已順利連線。 若要做快速測試,您可以執行一個 Exchange Online PowerShell Cmdlet (例如 Get-Mailbox),然後查看結果。

如果出現錯誤,請檢查下列需求:

  • 密碼錯誤是常見的問題。 再次執行這三個步驟,並特別留意您使用的使用者名稱和密碼。

  • 為防止拒絕服務 (DoS) 的攻擊,您最多只能對 Exchange Online 開啟五個遠端 PowerShell 連線。

  • 用來連接到的帳戶必須能夠使用遠端 PowerShell。 如需詳細資訊,請參閱啟用或停用 Exchange Online 的封存權

  • 必須在本機電腦與 Microsoft 365 之間開啟 TCP 連接埠 80 流量。 該連接埠可能已開啟,但必須考量您的組織是否有限制性網際網路存取原則。

  • 如果組織使用同盟驗證,而您的身分識別提供者 (IDP) 和/或安全性權杖服務 (STS) 並未公開提供,您就無法使用同盟帳戶連線到 Exchange Online PowerShell。 請改為在 Microsoft 365 中建立並使用非同盟帳戶以連線至 Exchange Online PowerShell。