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

输入

Microsoft.Online.SharePoint.PowerShell.SPOContainerPipeBind

输出

System.Object