Set-SPOContainer
设置或更新 SharePoint Embedded 中容器的一个或多个属性值。
语法
		ParamSet1
	 
	Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [[-SensitivityLabel] <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
		BlockDownloadPolicy
	  
	Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-BlockDownloadPolicy <Boolean>]
    [-ExcludeBlockDownloadPolicyContainerOwners <Boolean>]
    [-ReadOnlyForBlockDownloadPolicy <Boolean>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
		RestrictedAccessControl
	  
	Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-EnableRestrictedAccessControl <Boolean>]
    [-RestrictedAccessControlGroups <Guid[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
		RestrictedAccessControlGroupsToAdd
	    
	Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-RestrictedAccessControlGroupsToAdd <Guid[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
		RestrictedAccessControlGroupsToRemove
	    
	Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-RestrictedAccessControlGroupsToRemove <Guid[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
		ClearRestrictedAccessControl
	   
	Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-ClearRestrictedAccessControl]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
		ParamSet2
	 
	Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-RemoveLabel]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
		ConditionalAccess
	 
	Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-ConditionalAccessPolicy <SPOConditionalAccessPolicyType>]
    [-LimitedAccessFileType <SPOLimitedAccessFileType>]
    [-AllowEditing <Boolean>]
    [-ReadOnlyForUnmanagedDevices <Boolean>]
    [-AuthenticationContextName <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
		AllowDenyDomain
	  
	Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-SharingDomainRestrictionMode <SharingDomainRestrictionModes>]
    [-SharingAllowedDomainList <String>]
    [-SharingBlockedDomainList <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
		PrincipalOwnerTransfer
	  
	Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    -CurrentPrincipalOwner <String>
    -NewPrincipalOwner <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
		RestrictContentOrgWideSearch
	    
	Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-RestrictContentOrgWideSearch <Boolean>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
说明
对于传入的任何参数,cmdlet 设置 Set-SPOContainer 或更新由参数 Identity标识的活动容器的设置。 如果提供了存档容器的标识,则 cmdlet 将引发错误。 只有用户拥有的容器才支持主体所有者转移作。 尝试对非用户拥有的容器执行此作将导致错误。
重要
在重用 cmdlet 之前,请始终等待当前主体所有者转移尝试完成。 并发或过早重用可能会导致所有权更改不完整或无效。
您必须是 SharePoint Embedded 管理员才能运行 cmdlet。
有关 SharePoint 嵌入式容器Windows PowerShell的权限和最新信息,请参阅 SharePoint Embedded Containers 命令行管理程序简介中的联机文档。
示例
示例 1
Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -BlockDownloadPolicy $true
示例 1 设置 Identity 参数中提到的容器的“阻止下载”策略。
示例 2
Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -ConditionalAccessPolicy AllowLimitedAccess
在此示例中,为驻留在容器中的内容提供了有限的访问权限。
示例 3
Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -SensitivityLabel ab310e93-9f19-43f2-bc19-bf3386dc0956
本示例在容器上设置敏感度标签。
示例 4
Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -RemoveLabel
此示例删除容器上之前设置的任何敏感度标签。
参数
-AllowEditing 
		适用:SharePoint Online
阻止用户在浏览器中编辑 Office 文件,以及将 Office 文件内容复制和粘贴到浏览器窗口之外。
参数属性
| 类型: | System.Boolean | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					ConditionalAccess 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-AuthenticationContextName  
		适用:SharePoint Online
条件访问身份验证上下文名称。
参数属性
| 类型: | System.String | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					ConditionalAccess 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-BlockDownloadPolicy  
		适用:SharePoint Online
作为 SharePoint Embedded 管理员,您可以阻止从 SharePoint Embedded 容器下载文件。 此功能不需要Microsoft Entra条件访问策略。 可以为单个容器设置此功能,但不能在组织级别设置此功能。
阻止文件下载可让用户保持高效工作,同时解决意外丢失数据的风险。 用户仅具有浏览器访问权限,无法下载、打印或同步文件。 且无法通过应用(包括 Microsoft Office 桌面应用)访问内容。 限制 Web 访问时,用户将在容器顶部看到以下消息:“组织不允许你从此容器下载、打印或同步。 如需帮助,请联系 IT 部门。”阅读有关高级功能的完整文档,请参阅 SharePoint 容器和 OneDrive 的阻止下载策略。
参数属性
| 类型: | System.Boolean | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					BlockDownloadPolicy 
					
				  
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-ClearRestrictedAccessControl   
		适用:SharePoint Online
清除通过访问限制策略授予访问权限的组列表。
参数属性
| 类型: | SwitchParameter | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					ClearRestrictedAccessControl 
					
				   
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-ConditionalAccessPolicy  
		适用:SharePoint Online
阅读 控制来自非托管设备的访问 文档,了解 SharePoint Embedded 容器中的条件访问策略用法。
可能的值:
- AllowFullAccess:允许从桌面应用、移动应用和 Web 进行完全访问。
- AllowLimitedAccess:允许受限的仅限 Web 的访问。
- BlockAccess:阻止访问。
参数属性
| 类型: | Microsoft.Online.SharePoint.TenantManagement.SPOConditionalAccessPolicyType | 
| 默认值: | None | 
| 接受的值: | AllowFullAccess, AllowLimitedAccess, BlockAccess, AuthenticationContext | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					ConditionalAccess 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-Confirm
适用:SharePoint Online
提示你在运行 cmdlet 之前进行确认。
参数属性
| 类型: | System.Management.Automation.SwitchParameter | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
| 别名: | cf | 
参数集
(All)
| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-CurrentPrincipalOwner  
		适用:SharePoint Online
容器的当前主体所有者。
参数属性
| 类型: | String | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					PrincipalOwnerTransfer 
					
				  
				| Position: | Named | 
| 必需: | True | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-EnableRestrictedAccessControl   
		适用:SharePoint Online
允许你和其他 SharePoint Embedded 管理员限制对容器的访问。
参数属性
| 类型: | Boolean | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					RestrictedAccessControl 
					
				  
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-ExcludeBlockDownloadPolicyContainerOwners     
		适用:SharePoint Online
指定是否从阻止下载策略中排除容器所有者。
参数属性
| 类型: | System.Boolean | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					BlockDownloadPolicy 
					
				  
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-Identity
适用:SharePoint Online
使用此参数指定容器 URL。
参数属性
| 类型: | Microsoft.Online.SharePoint.PowerShell.SPOContainerPipeBind | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
(All)
| Position: | 0 | 
| 必需: | True | 
| 来自管道的值: | True | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-LimitedAccessFileType   
		适用:SharePoint Online
对于组织范围的设置和容器级设置,以下参数可与 -ConditionalAccessPolicy AllowLimitedAccess 一起使用。
OfficeOnlineFilesOnly:仅允许用户在浏览器中预览 Office 文件。 此选项可提高安全性,但可能会影响用户的工作效率。
LimitedAccessFileType WebPreviewableFiles (默认) :允许用户在浏览器中预览 Office 文件和其他文件类型 (,例如 PDF 文件和图像) 。 请注意,除 Office 文件以外的文件类型的内容在浏览器中进行处理。 此选项可针对用户工作效率进行优化,但对非 Office 文件的安全性较低。
LimitedAccessFileType OtherFiles:允许用户下载无法预览的文件,如 .zip 和 .exe。 此选项提供的安全性较低。
参数属性
| 类型: | Microsoft.Online.SharePoint.TenantManagement.SPOLimitedAccessFileType | 
| 默认值: | None | 
| 接受的值: | OfficeOnlineFilesOnly, WebPreviewableFiles, OtherFiles | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					ConditionalAccess 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-NewPrincipalOwner  
		适用:SharePoint Online
参数属性
| 类型: | String | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					PrincipalOwnerTransfer 
					
				  
				| Position: | Named | 
| 必需: | True | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-ReadOnlyForBlockDownloadPolicy     
		适用:SharePoint Online
控制是否应为阻止下载策略启用只读。
参数属性
| 类型: | System.Boolean | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					BlockDownloadPolicy 
					
				  
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-ReadOnlyForUnmanagedDevices    
		适用:SharePoint Online
控制非托管设备是否具有只读访问权限。
参数属性
| 类型: | System.Boolean | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					ConditionalAccess 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-RemoveLabel 
		适用:SharePoint Online
此参数允许删除容器上分配的敏感度标签。
参数属性
| 类型: | System.Management.Automation.SwitchParameter | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					ParamSet2 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-RestrictContentOrgWideSearch    
		适用:SharePoint Online
控制是否为容器启用组织范围的内容搜索。
参数属性
| 类型: | Boolean | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					RestrictContentOrgWideSearch 
					
				    
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-RestrictedAccessControlGroups   
		适用:SharePoint Online
指定在访问限制策略下具有访问权限的组 ID。
参数属性
| 类型: | Guid[] | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					RestrictedAccessControl 
					
				  
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-RestrictedAccessControlGroupsToAdd    
		适用:SharePoint Online
指定要添加到访问限制策略以授予访问权限的组 ID。
参数属性
| 类型: | Guid[] | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					RestrictedAccessControlGroupsToAdd 
					
				    
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-RestrictedAccessControlGroupsToRemove    
		适用:SharePoint Online
指定要从访问限制策略中删除以撤消访问权限的组 ID。
参数属性
| 类型: | Guid[] | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					RestrictedAccessControlGroupsToRemove 
					
				    
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-SensitivityLabel 
		适用:SharePoint Online
指定 SensitivityLabel (GUID) 的唯一标识符。
参数属性
| 类型: | System.String | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					ParamSet1 
					
				 
				| Position: | 1 | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-SharingAllowedDomainList   
		适用:SharePoint Online
指定允许与外部协作者共享的电子邮件域的列表。 使用空格字符作为分隔符来输入多个值。 例如,“contoso.com fabrikam.com”。
参数属性
| 类型: | System.String | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					AllowDenyDomain 
					
				  
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-SharingBlockedDomainList   
		适用:SharePoint Online
指定阻止或禁止与外部协作者共享的电子邮件域的列表。 使用空格字符作为分隔符来输入多个值。 例如,“contoso.com fabrikam.com”。
参数属性
| 类型: | System.String | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					AllowDenyDomain 
					
				  
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-SharingDomainRestrictionMode   
		适用:SharePoint Online
指定外部域的共享模式。
可能的值是:
- 无 - 不限制按域共享
- AllowList - 仅允许在 -SharingAllowedDomainList 指定的域上拥有帐户的外部用户共享
- BlockList - 允许与所有域中的外部用户共享,但使用 -SharingBlockedDomainList 指定的域除外
参数属性
| 类型: | Microsoft.Online.SharePoint.TenantManagement.SharingDomainRestrictionModes | 
| 默认值: | None | 
| 接受的值: | None, AllowList, BlockList | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					AllowDenyDomain 
					
				  
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-WhatIf 
		适用:SharePoint Online
显示在 cmdlet 运行时发生的情况。 此 cmdlet 未运行。
参数属性
| 类型: | System.Management.Automation.SwitchParameter | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
| 别名: | 无线 | 
参数集
(All)
| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。