Clear-SPOSiteRestrictedAppAccessControlList

Clear-SPOSiteRestrictedAppAccessControlList
    -Identity <String>
    -ListType <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Use o Clear-SPOSiteRestrictedAppAccessControlList cmdlet para limpar a lista de permissões ou de negações em um único site. Limpar uma lista preserva a outra lista, o modo ativo e a habilitação do site. Para remover a política completa, use Clear-SPOSiteRestrictedAppAccessControlPolicy.

Um site armazena ambas as listas, mas somente a lista selecionada pelo modo ativo participa da imposição:

• O modo de permissão impõe a lista de permissões. Os aplicativos listados passam na verificação de Restrições de Aplicativo e todos os outros aplicativos controlados são negados pela política do site.
• O modo de negação impõe a lista de negação. Os aplicativos listados são negados pela política do site e todos os outros aplicativos controlados passam na verificação de Restrições de Aplicativo.

Quando a lista limpa é aquela imposta pelo modo ativo, o cmdlet emite um aviso antes da confirmação. Limpar a lista de permissões ativas faz com que a política do site negue todos os aplicativos controlados de terceiros e agentes. Limpar a lista de negações ativas significa que a política do site não nega mais nenhum aplicativo controlado. Esse aviso descreve apenas a decisão da política de Restrições de Aplicativos e nunca significa que um aplicativo recebe acesso. O consentimento existente do Microsoft Entra e a autorização do SharePoint ainda se aplicam. O aviso também informa se a alteração entrará em vigor imediatamente ou quando a aplicação for habilitada na próxima vez.

A limpeza de uma lista inativa não altera a imposição atual, mas ainda dá suporte -WhatIf a e -Confirmé auditada.

A configuração e a ativação são ortogonais. As alterações de lista nunca ativam a imposição, portanto, limpar uma lista em um site que não está habilitado deixa o site desabilitado e prepara a alteração para a próxima vez que a imposição estiver habilitada com Enable-SPOSiteRestrictedAppAccessControl. Isso evita o caso perigoso em que adicionar uma única ID a um site não configurado ativaria imediatamente uma lista de permissões e bloquearia todos os outros aplicativos.

A opção de locatário bloqueia toda a imposição do site. Uma política de site não tem efeito enquanto a opção de locatário está desativada e a lista de negação de locatário não pode ser substituída por uma lista de permissões de site, portanto, limpar uma lista de negação de site nunca restaura o acesso de um aplicativo que o locatário nega.

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

A administração de Restrições de Aplicativos do Site é isolada dos cmdlets e Set-SPOSite de uso Get-SPOSite geral. As restrições de aplicativo são totalmente desacopladas do , portantoGet-SPOSite, não carregam dados da SitePropertiespolítica do site e Set-SPOSite não podem 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..

Clear-SPOSiteRestrictedAppAccessControlList -Identity "https://contoso.sharepoint.com/sites/Finance" -ListType DenyList

Este exemplo limpa a lista de negações no site de Finanças. Ele preserva a lista de permissões, o modo ativo e a habilitação do site. Se Deny for o modo ativo, o cmdlet avisará que a política do site não nega mais aplicativos controlados nessa lista. O consentimento existente do Microsoft Entra e a autorização do SharePoint ainda se aplicam.

Clear-SPOSiteRestrictedAppAccessControlList -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -ListType AllowList -WhatIf

Este exemplo identifica o site por ID de site e visualiza a limpeza da lista de permissões sem alterar a política. Cada cmdlet de Restrições de Aplicativo do site aceita -Identity como uma URL do site ou uma ID do site.

$url = "https://contoso.sharepoint.com/sites/Finance"
Clear-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"

Este exemplo recria uma lista de permissões do zero. Como as alterações de lista são apenas de configuração, nenhum dos comandos altera se o site está habilitado.

Clear-SPOSiteRestrictedAppAccessControlList -Identity "https://contoso.sharepoint.com/sites/Finance" -ListType DenyList -Confirm:$false

Este exemplo limpa a lista de negações sem um prompt de confirmação interativo, para uso em automação. O uso -Confirm:$false não ignora a validação, autorização, auditoria ou proteção de terceiros.

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.

Este cmdlet não retorna um objeto. Use Get-SPOSiteRestrictedAppAccessControl para ler a política resultante.

• Limpar uma lista preserva a outra lista, o modo ativo e a habilitação do site.
• Limpar a lista que o modo ativo impõe altera a decisão de política de Restrições do Aplicativo. 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. O cmdlet avisa antes da confirmação e informa se a alteração entra em vigor imediatamente ou quando a imposição está habilitada em seguida.
• A limpeza de uma lista inativa não altera a imposição atual, mas a operação ainda dá suporte -WhatIf e -Confirm é auditada.
• As alterações de lista nunca ativam a imposição. A imposição do site é ativada apenas por Enable-SPOSiteRestrictedAppAccessControl.
• A opção de locatário bloqueia toda a imposição do site, portanto, uma política de site não tem efeito enquanto a opção de locatário está desativada. A lista de negações do locatário não pode ser substituída por uma lista de permissões do site.
• As Restrições de Aplicativo nunca concedem permissões. Uma solicitação ainda deve passar a autorização existente do SharePoint.
• Este cmdlet é compatível -WhatIf com e -Confirm com ConfirmImpact.High. -Confirm:$false é permitido para automação e não ignora a validação, autorização, auditoria ou proteção de terceiros.