Set-SPOContainer

設定或更新 SharePoint Embedded 中容器的一或多個屬性值。

語法

ParamSet1

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [[-SensitivityLabel] <String>]
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlockDownloadPolicy

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-BlockDownloadPolicy <Boolean>]
    [-ExcludeBlockDownloadPolicyContainerOwners <Boolean>]
    [-ReadOnlyForBlockDownloadPolicy <Boolean>]
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RestrictedAccessControl

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-EnableRestrictedAccessControl <Boolean>]
    [-RestrictedAccessControlGroups <Guid[]>]
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RestrictedAccessControlGroupsToAdd

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-RestrictedAccessControlGroupsToAdd <Guid[]>]
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RestrictedAccessControlGroupsToRemove

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-RestrictedAccessControlGroupsToRemove <Guid[]>]
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ClearRestrictedAccessControl

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-ClearRestrictedAccessControl]
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ParamSet2

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-RemoveLabel]
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AddInformationBarrierSegments

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-AddInformationSegment <Guid[]>]
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RemoveInformationBarrierSegments

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-RemoveInformationSegment <Guid[]>]
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ConditionalAccess

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-ConditionalAccessPolicy <SPOConditionalAccessPolicyType>]
    [-LimitedAccessFileType <SPOLimitedAccessFileType>]
    [-AllowEditing <Boolean>]
    [-ReadOnlyForUnmanagedDevices <Boolean>]
    [-AuthenticationContextName <String>]
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AllowDenyDomain

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-SharingDomainRestrictionMode <SharingDomainRestrictionModes>]
    [-SharingAllowedDomainList <String>]
    [-SharingBlockedDomainList <String>]
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

PrincipalOwnerTransfer

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    -CurrentPrincipalOwner <String>
    -NewPrincipalOwner <String>
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RestrictContentOrgWideSearch

Set-SPOContainer
    [-Identity] <SPOContainerPipeBind>
    [-RestrictContentOrgWideSearch <Boolean>]
    [-InformationBarriersMode <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

針對傳入的任何參數, Set-SPOContainer Cmdlet 會設定或更新由參數 Identity所識別之使用中容器的設定。 如果已提供封存容器的身分識別,Cmdlet 會擲回錯誤。 只有使用者擁有的容器才支援主體擁有者轉移作業。 嘗試在非使用者擁有的容器上執行此作業會導致錯誤。

重要事項

請務必等待目前主體擁有者傳輸嘗試完成,然後再重複使用 Cmdlet。 並行或過早重複使用可能會導致所有權變更不完整或無效。

您必須是 SharePoint Embedded 系統管理員才能執行 Cmdlet。

如需有關適用於 SharePoint Embedded 容器的 Windows PowerShell 權限和最新資訊,請參閱 SharePoint Embedded 容器管理命令介面簡介中的線上文件。

範例

範例 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

此範例會移除容器上任何先前設定的敏感度標籤。

範例 5

Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -AddInformationSegment a17efb47-e3c9-4d85-a188-1cd59c83de32

此範例會將 InformationSegment 'a17efb47-e3c9-4d85-a188-1cd59c83de32' 新增至容器。

範例 6

Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -RemoveInformationSegment a17efb47-e3c9-4d85-a188-1cd59c83de32

在此範例中, InformationSegment 會從容器中移除 'a17efb47-e3c9-4d85-a188-1cd59c83de32'。

參數

-AddInformationSegment

此參數可讓您將區段新增至 SharePoint Embedded 容器。 若要使用此參數,您的租用戶必須已啟用 Microsoft 365 資訊屏障。 如需詳細資訊,請參閱 搭配 SharePoint 使用資訊屏障。

參數屬性

類型:

System.Guid[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

AddInformationBarrierSegments
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-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

-InformationBarriersMode

適用對象:SharePoint Online

指定資訊屏障模式。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值: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

-RemoveInformationSegment

此引數可讓您從 SharePoint Embedded 容器中移除區段。 此參數僅適用已啟用 Microsoft 365 資訊屏障的租用戶。

參數屬性

類型:

System.Guid[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

RemoveInformationBarrierSegments
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

指定在存取限制原則下具有存取權的群組識別碼。

參數屬性

類型:

Guid[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

RestrictedAccessControl
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RestrictedAccessControlGroupsToAdd

適用對象:SharePoint Online

指定要新增至存取限制原則以授與存取權的群組識別碼。

參數屬性

類型:

Guid[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

RestrictedAccessControlGroupsToAdd
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RestrictedAccessControlGroupsToRemove

適用對象:SharePoint Online

指定要從存取限制原則中移除以撤銷存取權的群組識別碼。

參數屬性

類型:

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

指定外部網域的共用模式。

可能的值為:

  • 無 - 不限制共用依網域
  • 允許清單 - 只允許與在以 -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
別名:WI

參數集

(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