開始使用 SharePoint Online 管理命令介面

若要開始使用 PowerShell 來管理 SharePoint Online,您需要安裝 SharePoint Online 管理命令介面並聯機到 SharePoint Online。

若要安裝 SharePoint Online 管理命令介面,請下載並執行 SharePoint Online 管理命令介面或從 PowerShell 資源庫安裝該模組。 安裝完成後,就可以使用該模組,而如果您需要在較新版本中推出的功能,就不需要再次安裝。 例如,在 2018 年 10 月之後,您可能需要安裝用於 TLS 1.2 交涉的新版本。

首先,您可以在 PowerShell 中以系統管理模式執行下列命令,以檢查您是否已安裝 SharePoint Online 管理命令介面:

Get-Module -Name Microsoft.Online.SharePoint.PowerShell -ListAvailable | Select Name,Version

如果您的作業系統使用 Windows PowerShell 5,您也可以在系統管理模式中執行下列命令來安裝 SharePoint Online 管理命令介面:

Install-Module -Name Microsoft.Online.SharePoint.PowerShell

如果您在系統上沒有系統管理許可權,您可以執行下列命令,只針對目前的使用者安裝 SharePoint Online 管理命令介面:

Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Scope CurrentUser

為了確保您擁有所有可用的 Cmdlet,您應該一律確定模組是最新狀態。 您可以在系統管理模式中執行下列命令來更新 SharePoint Online 管理命令介面:

Update-Module -Name Microsoft.Online.SharePoint.PowerShell

若要開啟 SharePoint Online 管理命令介面的命令提示字元,從 [開始] 畫面中輸入 sharepoint,然後按一下 [SharePoint Online 管理命令介面]。

利用使用者名稱和密碼連線

  1. 在 SharePoint Online 管理命令介面命令提示字元中執行下列命令:

    Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com
    
  2. 出現 [Windows PowerShell 認證要求] 對話方塊提示時,輸入 SharePoint 系統管理員帳戶的密碼。

若要將 SharePoint 系統管理員角色指派給使用者,請參閱使用 PowerShell 指派系統管理員角色將系統管理員角色指派給 Microsoft 365 使用者帳戶

注意

如果您嘗試連線或收到錯誤,例如「錯誤訊息:無法連線到 SharePoint Online」時遇到問題,您可能需要使用新式驗證。 請參閱下列範例:

Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations

使用多重要素驗證 (MFA) 連線

  1. 在 SharePoint Online 管理命令介面命令提示字元中執行下列命令:

    Connect-SPOService -Url https://contoso-admin.sharepoint.com
    
  2. 出現 [Microsoft SharePoint Online 管理命令介面] 對話方塊提示時,輸入 SharePoint 系統管理員帳戶的帳戶名稱和密碼,然後按一下 [登入]。

  3. 遵循 [Microsoft SharePoint Online 管理命令介面] 對話方塊中的指示,提供其他驗證資訊 (例如驗證碼),然後按一下 [登入]。

您現在可以開始使用 SharePoint Online 命令。

注意

SharePoint Online 管理命令介面模組與 SharePoint 用戶端元件 SDK 之間有一個已知問題,如果兩者都安裝在同一部電腦上,模組將無法載入。 如果您遇到此問題,請卸載 SharePoint 用戶端元件 SDK。