Set-SPOContainer
Sets or updates one or more property values for a Container in SharePoint Embedded.
Syntax
Set-SPOContainer
[-Identity]
[-BlockDownloadPolicy <Boolean>]
[-ConditionalAccessPolicy <SPOConditionalAccessPolicyType>]
[-SensitivityLabel <String>]
[-RemoveLabel]
Description
For any parameters that are passed in, the Set-SPOContainer
cmdlet sets or updates the setting for the Container collection identified by the parameter Identity.
You must be at least a SharePoint administrator to run the cmdlet.
For permissions and the most current information about Windows PowerShell for SharePoint Embedded Containers, see the online documentation at Intro to SharePoint Embedded Containers Management Shell.
Examples
Example 1
Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -BlockDownloadPolicy $true
Example 1 sets the Block Download policy on the Container mentioned in the Identity parameter.
Example 2
Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -ConditionalAccessPolicy AllowLimitedAccess
In this example, limited access is provided to content residing in the Container.
Example 3
Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -SensitivityLabel ab310e93-9f19-43f2-bc19-bf3386dc0956
This example sets a sensitivity label on the Container.
Example 4
Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -RemoveLabel
This example sets any previously set sensitivity label on the Container.
Parameters
-BlockDownloadPolicy
As a SharePoint Administrator or above in Microsoft 365, you can block the download of files from SharePoint Embedded Containers. This feature does not need Microsoft Entra Conditional Access policies. This feature can be set for individual Containers but not at the organization level.
Blocking the download of files allows users to remain productive while addressing the risk of accidental data loss. Users have browser-only access with no ability to download, print, or sync files. They also won't be able to access content through apps, including the Microsoft Office desktop apps. When web access is limited, users will see the following message at the top of Containers: "Your organization doesn't allow you to download, print, or sync from this Container. For help contact your IT department." Read the full documentation for advanced capabilities at Block download policy for SharePoint Containers and OneDrive.
PARAMVALUE: $true | $false
Type: | Boolean |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Embedded |
-ConditionalAccessPolicy
Read the Control access from unmanaged devices documentation to understand Conditional Access Policy usage in SharePoint Embedded Container.
Possible values:
- AllowFullAccess: Allows full access from desktop apps, mobile apps, and the web.
- AllowLimitedAccess: Allows limited, web-only access.
- BlockAccess: Blocks access.
Type: | SPOConditionalAccessPolicyType |
Position: | Named |
Default value: | AllowFullAccess |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Embedded |
-RemoveLabel
This parameter allows you to remove the assigned sensitivity label on a Container.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SensitivityLabel
Specifies the unique identifier (GUID) of the SensitivityLabel.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Embedded |