Set-SPOSiteRestrictedAppAccessControlMode

Módulo:
Microsoft.Online.SharePoint.PowerShell Module

Define o modo ativo da política de Restrições de Aplicativos no nível do site como Allow ou Deny, preservando a habilitação do site e ambas as listas.

Sintaxe

Default (Default) 

Set-SPOSiteRestrictedAppAccessControlMode
    [-Identity] <String>
    -Mode <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Use o Set-SPOSiteRestrictedAppAccessControlMode cmdlet para alterar qual lista um site aplica. Este cmdlet altera apenas o modo ativo. Ele preserva a habilitação do site e a lista de permissões e a lista de negações.

As Restrições de Aplicativo adicionam um limite de autorização do SharePoint para aplicativos que já têm permissões do SharePoint e consentimento do Microsoft Entra. Ele nunca concede permissões e não substitui o consentimento do Entra. Uma solicitação deve passar pelo modelo de permissão existente e pelas Restrições de Aplicativo.

O modo ativo seleciona a lista que é imposta:

  • Permitir - os aplicativos na lista de permissões passam na marca de Restrições de Aplicativos e todos os outros aplicativos controlados são negados pela política do site. Uma lista de permissões ativa vazia faz com que a política do site negue todos os aplicativos controlados de terceiros e agenciados.
  • Negar - os aplicativos na lista de negações são negados pela política do site e todos os outros aplicativos controlados passam na marca de Restrições de Aplicativo. Uma lista de negações ativa vazia significa que a política do site não nega nenhuma delas.

Ambas as listas são sempre armazenadas e podem ser gerenciadas, independentemente de qual modo está ativo. Somente a lista selecionada pelo modo ativo participa da imposição de tempo de execução. A lista inativa é preservada para futuras alterações de modo e não tem efeito de runtime. Um modo deve ser configurado explicitamente antes que a política do site possa ser habilitada.

Como uma opção de modo pode alterar a decisão efetiva para cada aplicativo controlado no site, o cmdlet exibe um aviso antes de fazer a alteração. O aviso identifica o modo atual, o modo de destino, o tamanho da lista preservada recém-ativa e a nova decisão padrão, e afirma claramente que ambas as listas são preservadas. Em seguida, o cmdlet solicitará que você confirme. Use -WhatIf para exibir o mesmo impacto sem alterar a política.

A configuração e a habilitação são ortogonais: uma alteração de modo nunca ativa a imposição. A imposição do site é ativada apenas por Enable-SPOSiteRestrictedAppAccessControl, para que você possa preparar um modo e listas e, em seguida, habilitar o site explicitamente. A única combinação que o back-end rejeita é habilitada com o modo None.

A imposição do site também é controlada pelo comutador de locatário. Enquanto a opção de locatário estiver ativada, a lista de negação de locatário tem precedência e não pode ser substituída por uma lista de permissões de site.

A automação pode usar o padrão -Confirm:$false. Suprimir o prompt não ignora a validação, autorização, auditoria ou proteção de terceiros.

A administração de Restrições de Aplicativos do Site é isolada dos cmdlets e Set-SPOSite de uso Get-SPOSite geral. Get-SPOSite Não carrega dados da política do site e Set-SPOSite não pode alterá-los. Use os cmdlets de Restrições de Aplicativos dedicados listados em Links Relacionados.

Para obter permissões e as informações mais recentes sobre o Windows PowerShell do SharePoint Online, consulte a documentação on-line em Introdução ao Shell de gerenciamento do SharePoint Online..

Exemplos

Exemplo 1

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow

Este exemplo define o modo ativo do site de Finanças como Allow. Os aplicativos na lista de permissões do site passam na marca de Restrições de Aplicativo e todos os outros aplicativos controlados são negados pela política do site. O consentimento existente do Microsoft Entra e a autorização do SharePoint ainda se aplicam. A lista de negações é preservada, mas torna-se inativa. O cmdlet exibe o aviso de alteração de modo e pede confirmação antes de aplicar a alteração.

Exemplo 2

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Deny -WhatIf

Este exemplo exibe o impacto da alternância do site de Finanças para Deny, incluindo o modo atual, o modo de destino, o tamanho da lista de negações recém-ativa e a nova decisão padrão, sem alterar a política.

Exemplo 3

Set-SPOSiteRestrictedAppAccessControlMode -Identity 8a1e30f6-2f52-4b9e-9d1b-2e9f6c1d40aa -Mode Deny -Confirm:$false

Este exemplo alterna um site identificado por sua ID para Deny sem solicitação, para uso em automação. Suprimir o prompt não ignora a validação, autorização, auditoria ou proteção de terceiros.

Exemplo 4

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow
Enable-SPOSiteRestrictedAppAccessControl -Identity https://contoso.sharepoint.com/sites/Finance

Este exemplo prepara o modo primeiro e, em seguida, ativa a imposição explicitamente. Uma alteração de modo nunca ativa a imposição por si só.

Parâmetros

-Confirm

Aplicável: SharePoint Online

Solicita a confirmação antes de executar o cmdlet. Este cmdlet usa ConfirmImpact.High, portanto, solicita por padrão. Use -Confirm:$false para suprimir o prompt na automação.

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

-Identity

Aplicável: SharePoint Online

Especifica o site a ser configurado. Você pode especificar a URL do site ou a ID do site.

Propriedades do parâmetro

Tipo:System.String
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

-Mode

Aplicável: SharePoint Online

Especifica o modo ativo da política do site. Os valores válidos são Allow e Deny.

Quando o modo é Allow, os aplicativos na lista de permissões passam na marca de Restrições de Aplicativos e todos os outros aplicativos controlados são negados pela política do site. Quando o modo é Deny, os aplicativos na lista de negações são negados pela política do site e todos os outros aplicativos controlados passam na marca de Restrições de Aplicativo. Ambas as listas são preservadas de qualquer maneira. O consentimento existente do Microsoft Entra e a autorização do SharePoint ainda se aplicam.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Valores aceitos:Allow, Deny
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
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. -WhatIf Exibe o mesmo impacto na mudança de modo que o aviso de confirmação sem alterar a política.

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

System.String

Saídas

None

Observações

  • Uma alteração de modo altera apenas o modo ativo. Preserva a habilitação do site e ambas as listas.
  • Antes da alternância, o cmdlet avisa com o modo atual, o modo de destino, o tamanho da lista preservada recém-ativa e a nova decisão padrão.
  • O aviso informa que ambas as listas são preservadas e o cmdlet pede confirmação.
  • Uma lista de permissões ativa vazia faz com que a política do site negue todos os aplicativos controlados de terceiros e agenciados. Uma lista de negações ativa vazia significa que a política do site não nega nenhuma delas. O consentimento existente do Microsoft Entra e a autorização do SharePoint ainda se aplicam.
  • A configuração e a ativação são ortogonais. A imposição do site é ativada apenas por Enable-SPOSiteRestrictedAppAccessControl. A única combinação que o back-end rejeita é habilitada com o modo None.
  • A opção de locatário bloqueia toda a imposição do site. Enquanto a opção de locatário estiver ativada, a lista de negação de locatário não pode ser substituída por uma lista de permissões de site.
  • Use Get-SPOSiteRestrictedAppAccessControl para confirmar o modo resultante e ambas as listas.