Connect-SPOService

  • 參考
模組:
Microsoft.Online.SharePoint.PowerShell
適用於:
SharePoint Online

將 SharePoint Online 系統管理員或全域管理員連線到 SharePoint Online 管理中心) (SharePoint Online 連線。 必須先執行此 Cmdlet，才能執行任何其他 SharePoint Online Cmdlet。

Syntax

Connect-SPOService
       -AuthenticationUrl <String>
       [-ClientTag <String>]
       [-Credential <CredentialCmdletPipeBind>]
       -Url <UrlCmdletPipeBind>
       -ModernAuth <Boolean>
       [<CommonParameters>]
Connect-SPOService
       [-ClientTag <String>]
       [-Credential <CredentialCmdletPipeBind>]
       [-Region <AADCrossTenantAuthenticationLocation>]
       -Url <UrlCmdletPipeBind>
       [<CommonParameters>]

Description

此 Connect-SPOService Cmdlet 會將 SharePoint Online 系統管理員或全域管理員連線到 SharePoint Online 系統管理中心。

只會從任何單一Windows PowerShell會話維護單一 SharePoint Online 服務連線。 換句話說，這是組織系統管理員連線內的每個地理位置。 執行 Cmdlet Connect-SPOService 兩次會隱含地中斷先前的連線。 Windows PowerShell會話將會設定為為指定的新 SharePoint Online 系統管理員提供服務。

委派的合作夥伴系統管理員必須為相同Windows PowerShell會話內的不同組織交換連線。

您必須是 SharePoint Online 系統管理員或全域系統管理員，才能執行 Cmdlet。

如需有關適用於 SharePoint Online 的 Windows PowerShell 權限和最新資訊，請參閱位於 SharePoint Online Management Shell 簡介的線上文件。

範例

-----------------------範例 1-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com -credential admin@contoso.com

範例 1 顯示具有認證 admin@contoso.com 的 SharePoint Online 系統管理員或全域管理員如何連線到具有 URL 的 SharePoint Online 系統管理中心 https://contoso-admin.sharepoint.com.

-----------------------範例 2-----------------------------

$username = "admin@contoso.sharepoint.com"
$password = "password"
$cred = New-Object -TypeName System.Management.Automation.PSCredential -argumentlist $userName, $(convertto-securestring $Password -asplaintext -force)
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential $cred

範例 2 顯示具有使用者名稱和密碼的 SharePoint Online 系統管理員或全域管理員如何連線到具有 URL 的 SharePoint Online 系統管理中心 https://contoso-admin.sharepoint.com.

-----------------------範例 3-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com

提示輸入認證。 如果帳戶使用多重要素驗證，則這是必要的。

-----------------------範例 4-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com -Region ITAR

連線至指定區域的 SharePoint Online 系統管理中心。

-----------------------範例 5-----------------------------

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

使用 ModernAuth 旗標連線到 SPO 服務。

參數

-AuthenticationUrl

AAD 跨租使用者驗證服務的位置。 如果使用非預設的跨租使用者驗證服務，則可以選擇性地使用。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-ClientTag

允許將用戶端標籤附加至現有的用戶端標記。 選擇性地在 CSOM HTTP 流量中使用，以識別已使用的腳本或解決方案。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Credential

指定要用來連接的認證。 如果未顯示任何認證，對話方塊會提示您輸入認證。 認證必須是可存取 SharePoint Online 管理中心網站的 SharePoint Online 系統管理員或全域管理員。

Type:CredentialCmdletPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online

-ModernAuth

確保 SharePoint Online 租使用者管理 Cmdlet 可以使用新式 TLS 通訊協定連線到服務。

若要使用它，您也需要提供 AuthenticationUrl 參數。

Type:Boolean
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Region

有效值為：預設值 |ITAR |德國 |中國

預設值為 「default」。

注意：ITAR 值僅適用于 GCC High 和 DoD 租用。

Type:AADCrossTenantAuthenticationLocation
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Url

指定 SharePoint Online 管理中心網站的 URL。

Type:UrlCmdletPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online