共用方式為


連線至 Exchange Online Protection PowerShell

本文包含如何使用 Exchange Online PowerShell 模組連線到 Exchange Online Protection PowerShell 的指示,無論是否使用多重要素驗證 (MFA) 。

Exchange Online PowerShell 模組會使用新式驗證連線到 Microsoft 365 中的所有 Exchange 相關 PowerShell 環境:Exchange Online PowerShell、安全性 & 合規性 PowerShell,以及獨立 Exchange Online Protection (EOP) PowerShell。 如需模組的詳細資訊,請 參閱關於 Exchange Online PowerShell 模組

如需 Exchange Online Protection PowerShell 的詳細資訊,請參 閱 Exchange Online Protection PowerShell

注意事項

自 2020 年 6 月起,連線到獨立 Exchange Online Protection PowerShell 和 Exchange Online PowerShell 的指示基本上相同。 如果您使用 Connect-IPPSSession Cmdlet 搭配 ConnectionUri 參數值 https://ps.protection.outlook.com/powershell-liveid/,則會將您重新導向至 Exchange Online PowerShell 連線的 Connect-ExchangeOnline 所使用的相同https://outlook.office365.com/powershell-liveid/端點。

Exchange Online PowerShell 中的遠端 PowerShell 連線已被取代。 如需詳細資訊,請參閱 在 Exchange Online 中淘汰遠端 PowerShell

Exchange Online PowerShell V3 模組中的 REST API 連線需要 PowerShellGet 和 PackageManagement 模組。 如需詳細資訊,請參閱 Windows 中 REST 型連線的 PowerShellGet

開始之前有哪些須知?

提示

有問題嗎? 在 Exchange Online Protection 論壇中尋求協助。

使用具有或不含 MFA 的新式驗證連線到 Exchange Online Protection PowerShell

這些連線指示會使用新式驗證,並可使用或不使用多重要素驗證 (MFA)。

步驟 1:載入 Exchange Online PowerShell 模組

注意事項

如果模組已安裝,您通常可以略過此步驟並執行 Connect-ExchangeOnline, 而不需要先手動載入模組。

安裝模組之後,請開啟 PowerShell 視窗,然後執行下列命令來載入模組:

Import-Module ExchangeOnlineManagement

步驟 2:連線和驗證

注意事項

如果您用來連線之帳戶的配置檔路徑包含特殊 PowerShell 字元 (例如,) , $ 則連線命令可能會失敗。 因應措施是使用配置檔路徑中沒有特殊字元的不同帳戶進行連線。

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

Connect-ExchangeOnline -UserPrincipalName <UPN> [-ShowBanner:$false]

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

使用互動式登入提示連線到 Exchange Online Protection PowerShell

此範例適用於具有或不含 MFA 之帳戶的 Windows PowerShell 5.1 和 PowerShell 7:

Connect-ExchangeOnline -UserPrincipalName navin@contoso.onmicrosoft.com

步驟 3:當您完成時中斷連線

完成時,請務必中斷會話的連線。 如果您關閉 PowerShell 視窗而不中斷工作階段的連線,您可以用掉所有可供您使用的工作階段,而且您必須等候工作階段到期。 若要中斷會話的連線,請執行下列命令:

Disconnect-ExchangeOnline

若要在沒有確認提示的情況下以無訊息方式中斷連線,請執行下列命令:

Disconnect-ExchangeOnline -Confirm:$false

如何知道您已成功連線?

Exchange Online Protection 指令程式會匯入您的本機 Windows PowerShell 工作階段中,且會有進度列追蹤此作業。 如果您未收到任何錯誤,表示您已成功連線。 快速測試是執行 Exchange Online Protection Cmdlet,例如 Get-AcceptedDomain,並查看結果。

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

  • 密碼錯誤是常見的問題。 再次執行連線步驟,並密切注意您使用的使用者名稱和密碼。

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

  • 如果您的用戶端 IP 位址在連線要求其間變更,則您可能會無法連線。 如果您的組織使用的來源網路位址轉譯 (SNAT) 集區包含多個 IP 位址,則可能會發生次情況。 連線錯誤看起來會像這樣:

    要求具有ShellId <標識> 碼的Windows遠端殼層失敗,因為在伺服器上找不到殼層。 可能的原因如下:指定的 ShellId 不正確,或者伺服器上已不存在 Shell。 提供正確的 ShellId 或建立新的 Shell,然後重試操作。

    若要修正此問題,請使用 SNAT 集區 (其中包含單一 IP 位址),或讓 Exchange Online Protection PowerShell 端點的連線強制使用特定的 IP 位址。