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 |