Connect-SPOService

将SharePoint联机管理员或全局管理员连接到SharePoint联机管理中心) (SharePoint联机连接。 必须先运行此 cmdlet,然后才能运行任何其他SharePoint Online cmdlet。

语法

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

说明

Connect-SPOService cmdlet 将SharePoint联机管理员或全局管理员连接到 SharePoint Online 管理中心。

仅从任何单个Windows PowerShell会话维护单个SharePoint联机服务连接。 换句话说,这是组织管理员连接中的每个地理位置。 Connect-SPOService运行 cmdlet 两次隐式断开上一个连接。 Windows PowerShell会话将设置为为指定的新SharePoint联机管理员提供服务。

委派的合作伙伴管理员必须在同一Windows PowerShell会话中为不同的组织交换连接。

你必须是 SharePoint Online 管理员或全局管理员才能运行 cmdlet。

有关适用于 SharePoint Online 的 Windows PowerShell 的权限和最新信息,请参阅在线文档简介 SharePoint Online 命令行管理程序的简介

示例

-----------------------示例 1-----------------------------

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

示例 1 演示具有凭据的SharePoint联机管理员或全局管理员 admin@contoso.com 如何连接到具有 URL 的SharePoint联机管理中心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联机管理员或全局管理员如何连接到具有 URL 的SharePoint联机管理中心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联机管理中心。

参数

-AuthenticationUrl

AAD 跨租户身份验证服务的位置。 如果使用非默认跨租户身份验证服务,则可以选择使用。

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

允许将客户端标记追加到现有客户端标记。 在 CSOM http 流量中选择性地用于标识已用脚本或解决方案。

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

指定用于连接的凭据。 如果未提供凭据,则将出现一个提示输入凭据的对话框。 凭据必须是可以访问SharePoint联机管理中心网站的SharePoint联机管理员或全局管理员的凭据。

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

有效值为:默认|ITAR |德国|中国

默认值为“default”。

注意:ITAR 值仅适用于 GCC High 和 DoD 租户。

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

指定SharePoint联机管理中心网站的 URL。

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