Set-SPOContainer

Define ou atualiza um ou mais valores de propriedade para um contêiner no SharePoint Embedded.

Sintaxe

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

Para todos os parâmetros passados, o Set-SPOContainer cmdlet define ou atualiza a configuração para o contêiner ativo identificado pelo parâmetro Identity. O cmdlet gerará um erro se a identidade de um contêiner arquivado for fornecida. A operação de transferência do proprietário principal tem suporte apenas para contêineres de propriedade do usuário. A tentativa de executar esta operação em contêineres que não são de propriedade do usuário resultará em um erro.

Importante

Sempre aguarde a conclusão da tentativa de transferência do proprietário da entidade de segurança atual antes de reutilizar o cmdlet. A reutilização concomitante ou prematura pode levar a alterações de propriedade incompletas ou inválidas.

Você deve ser um Administrador do SharePoint Embedded para executar o cmdlet.

Para obter permissões e as informações mais atualizadas sobre o Windows PowerShell para Contêineres Incorporados do SharePoint, confira a documentação online em Introdução ao Shell de Gerenciamento de Contêineres Incorporados do SharePoint.

Exemplos

Exemplo 1

Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -BlockDownloadPolicy $true

O Exemplo 1 define a política de Download em Bloco no Contêiner mencionado no parâmetro Identity.

Exemplo 2

Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -ConditionalAccessPolicy AllowLimitedAccess

Neste exemplo, é fornecido acesso limitado ao conteúdo que reside no contêiner.

Exemplo 3

Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -SensitivityLabel ab310e93-9f19-43f2-bc19-bf3386dc0956

Este exemplo define um rótulo de confidencialidade no contêiner.

Exemplo 4

Set-SPOContainer -Identity https://contoso.sharepoint.com/contentstorage/CSP_33a63968-abae-49a3-a255-f83d0ab2260a/ -RemoveLabel

Este exemplo remove qualquer rótulo de confidencialidade definido anteriormente no contêiner.

Exemplo 5

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

Este exemplo adiciona InformationSegment "a17efb47-e3c9-4d85-a188-1cd59c83de32" ao contêiner.

Exemplo 6

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

Neste exemplo, InformationSegment "a17efb47-e3c9-4d85-a188-1cd59c83de32" é removido do contêiner.

Parâmetros

-AddInformationSegment

Esse parâmetro permite adicionar um segmento a um contêiner do SharePoint Embedded. Para usar esse parâmetro, seu locatário deve ter as Barreiras de Informações do Microsoft 365 habilitadas. Para obter mais informações, consulte Usar Barreiras de Informações com o SharePoint.

Propriedades do parâmetro

Tipo:

System.Guid[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AddInformationBarrierSegments
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AllowEditing

Aplicável: SharePoint Online

Impede que os usuários editem arquivos do Office no navegador e copiem e colem o conteúdo dos arquivos do Office fora da janela do navegador.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ConditionalAccess
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AuthenticationContextName

Aplicável: SharePoint Online

O nome do contexto de autenticação de acesso condicional.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ConditionalAccess
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-BlockDownloadPolicy

Aplicável: SharePoint Online

Como administrador do SharePoint Embedded, você pode bloquear o download de arquivos de contêineres do SharePoint Embedded. Esse recurso não precisa de políticas de Acesso Condicional do Microsoft Entra. Esse recurso pode ser definido para contêineres individuais, mas não no nível da organização.

O bloqueio do download de arquivos permite que os usuários permaneçam produtivos enquanto lidam com o risco de perda acidental de dados. Os usuários têm acesso somente ao navegador, sem capacidade de baixar, imprimir ou sincronizar arquivos. Eles também não poderão acessar conteúdo por meio de aplicativos, incluindo os aplicativos da área de trabalho do Microsoft Office. Quando o acesso à Web for limitado, os usuários verão a seguinte mensagem na parte superior dos contêineres: "Sua organização não permite que você baixe, imprima ou sincronize deste contêiner. Para obter ajuda, entre em contato com seu departamento de TI." Leia a documentação completa para recursos avançados em Bloquear política de download para Contêineres do SharePoint e OneDrive.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

BlockDownloadPolicy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ClearRestrictedAccessControl

Aplicável: SharePoint Online

Limpa a lista de grupos que recebem acesso por meio de uma política de restrição de acesso.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ClearRestrictedAccessControl
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ConditionalAccessPolicy

Aplicável: SharePoint Online

Leia a documentação Controlar o acesso de dispositivos não gerenciados para entender o uso da Política de Acesso Condicional no contêiner do SharePoint Embedded.

Valores possíveis:

  • AllowFullAccess: permite acesso total de aplicativos da área de trabalho, aplicativos móveis e aplicativos Web.
  • AllowLimitedAccess: permite acesso limitado apenas pela Web.
  • BlockAccess: bloqueia o acesso.

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.TenantManagement.SPOConditionalAccessPolicyType
Valor padrão:None
Valores aceitos:AllowFullAccess, AllowLimitedAccess, BlockAccess, AuthenticationContext
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ConditionalAccess
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: SharePoint Online

Solicita a confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CurrentPrincipalOwner

Aplicável: SharePoint Online

O atual proprietário principal do contêiner.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

PrincipalOwnerTransfer
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EnableRestrictedAccessControl

Aplicável: SharePoint Online

Permite que você e outros administradores do SharePoint Embedded restrinjam o acesso aos contêineres.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RestrictedAccessControl
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExcludeBlockDownloadPolicyContainerOwners

Aplicável: SharePoint Online

Especifica se os proprietários de contêineres são excluídos da política de bloqueio de download.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

BlockDownloadPolicy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: SharePoint Online

Use este parâmetro para especificar a URL do contêiner.

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.PowerShell.SPOContainerPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InformationBarriersMode

Aplicável: SharePoint Online

Especifica o modo de barreira de informações.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LimitedAccessFileType

Aplicável: SharePoint Online

Os parâmetros a seguir podem ser usados com -ConditionalAccessPolicy AllowLimitedAccess para a configuração de toda a organização e a configuração de nível de contêiner.

OfficeOnlineFilesOnly: permite que os usuários visualizem apenas arquivos do Office no navegador. Essa opção aumenta a segurança, mas pode ser uma barreira para a produtividade do usuário.

LimitedAccessFileType WebPreviewableFiles (padrão): permite que os usuários visualizem arquivos do Office e outros tipos de arquivos (como arquivos PDF e imagens) no navegador. Observe que o conteúdo dos tipos de arquivo diferentes dos arquivos do Office é processado no navegador. Essa opção otimiza a produtividade do usuário, mas oferece menos segurança para arquivos que não são do Office.

LimitedAccessFileType OtherFiles: permite que os usuários baixem arquivos que não podem ser visualizados, como .zip e .exe. Esta opção oferece menos segurança.

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.TenantManagement.SPOLimitedAccessFileType
Valor padrão:None
Valores aceitos:OfficeOnlineFilesOnly, WebPreviewableFiles, OtherFiles
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ConditionalAccess
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NewPrincipalOwner

Aplicável: SharePoint Online

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

PrincipalOwnerTransfer
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ReadOnlyForBlockDownloadPolicy

Aplicável: SharePoint Online

Controla se o modo somente leitura deve ser habilitado para a política de download em bloco.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

BlockDownloadPolicy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ReadOnlyForUnmanagedDevices

Aplicável: SharePoint Online

Controla se os dispositivos não gerenciados têm acesso somente leitura.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ConditionalAccess
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveInformationSegment

Esse parâmetro permite que você remova um segmento de um contêiner do SharePoint Embedded. Esse parâmetro está disponível somente para locatários com Barreiras de Informações do Microsoft 365 habilitadas.

Propriedades do parâmetro

Tipo:

System.Guid[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RemoveInformationBarrierSegments
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveLabel

Aplicável: SharePoint Online

Esse parâmetro permite remover o rótulo de confidencialidade atribuído em um contêiner.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ParamSet2
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RestrictContentOrgWideSearch

Aplicável: SharePoint Online

Controla se a pesquisa de conteúdo em toda a organização está habilitada para um contêiner.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RestrictContentOrgWideSearch
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RestrictedAccessControlGroups

Aplicável: SharePoint Online

Especifica as IDs de grupo que têm acesso sob uma política de restrição de acesso.

Propriedades do parâmetro

Tipo:

Guid[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RestrictedAccessControl
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RestrictedAccessControlGroupsToAdd

Aplicável: SharePoint Online

Especifica as IDs de grupo a serem adicionadas a uma política de restrição de acesso para conceder acesso.

Propriedades do parâmetro

Tipo:

Guid[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RestrictedAccessControlGroupsToAdd
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RestrictedAccessControlGroupsToRemove

Aplicável: SharePoint Online

Especifica as IDs de grupo a serem removidas de uma política de restrição de acesso para revogar o acesso.

Propriedades do parâmetro

Tipo:

Guid[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RestrictedAccessControlGroupsToRemove
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SensitivityLabel

Aplicável: SharePoint Online

Especifica o identificador exclusivo (GUID) do SensitivityLabel.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ParamSet1
Cargo:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SharingAllowedDomainList

Aplicável: SharePoint Online

Especifica uma lista de domínios de email que têm permissão para compartilhamento com os colaboradores externos. Use o caractere de espaço como delimitador para inserir vários valores. Por exemplo, "contoso.com fabrikam.com".

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AllowDenyDomain
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SharingBlockedDomainList

Aplicável: SharePoint Online

Especifica uma lista de domínios de email bloqueados ou proibidos para compartilhamento com colaboradores externos. Use o caractere de espaço como delimitador para inserir vários valores. Por exemplo, "contoso.com fabrikam.com".

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AllowDenyDomain
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SharingDomainRestrictionMode

Aplicável: SharePoint Online

Especifica o modo de compartilhamento de domínios externos.

Os valores possíveis são:

  • None - Não restringir o compartilhamento por domínio
  • AllowList - O compartilhamento é permitido somente com usuários externos que tenham conta em domínios especificados com -SharingAllowedDomainList
  • Lista de bloqueio: o compartilhamento é permitido com usuários externos em todos os domínios, exceto nos domínios especificados com -SharingBlockedDomainList

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.TenantManagement.SharingDomainRestrictionModes
Valor padrão:None
Valores aceitos:None, AllowList, BlockList
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AllowDenyDomain
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: SharePoint Online

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

Entradas

Microsoft.Online.SharePoint.PowerShell.SPOContainerPipeBind

Saídas

System.Object