Connect-SPOService

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

语法

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

说明

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

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

委派的合作伙伴管理员必须在同一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 显示了具有凭据 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

有效值为:Default |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