Clear-SPOSiteRestrictedAppAccessControlPolicy

Clear-SPOSiteRestrictedAppAccessControlPolicy
    -Identity <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Use o Clear-SPOSiteRestrictedAppAccessControlPolicy cmdlet para retornar um site ao seu estado não configurado. O cmdlet desabilita a imposição, remove o modo ativo e ambas as listas e limpa a política de site armazenada. Depois que a política é limpa, o site está no mesmo estado de um site que nunca foi configurado: a aplicação está desabilitada e não há entradas.

Limpar é diferente de desabilitar. Disable-SPOSiteRestrictedAppAccessControl Desativa a imposição, mas preserva o modo ativo e ambas as listas para que a mesma configuração possa ser reabilitada mais tarde. Use Clear-SPOSiteRestrictedAppAccessControlPolicy quando quiser que a configuração seja removida também. Para limpar apenas uma lista e manter a outra lista, o modo e a habilitação do site, use Clear-SPOSiteRestrictedAppAccessControlList.

Como o modo é removido junto com as listas, um site limpo não pode ser habilitado novamente até que um modo seja definido. Enable-SPOSiteRestrictedAppAccessControl falha quando nenhum modo é definido; Habilitado com o modo None é a única combinação que o back-end rejeita. Recrie a política com Set-SPOSiteRestrictedAppAccessControlMode e Set-SPOSiteRestrictedAppAccessControlList, habilite-a explicitamente. A configuração e a habilitação são ortogonais: as alterações de modo e lista nunca ativam a imposição, portanto, um administrador pode preparar uma política e habilitá-la. 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 limpeza de uma política de site afeta apenas esse site. A opção de locatário bloqueia toda a imposição do site 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 política de site nunca restaura o acesso de um aplicativo que o locatário nega. Use Clear-SPOTenantRestrictedAppAccessControlPolicy para o escopo do locatário.

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, portanto, limpar uma política do site não concede acesso a nenhum aplicativo que ele ainda não tenha.

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-SPOSiteRestrictedAppAccessControlPolicy -Identity "https://contoso.sharepoint.com/sites/Finance"

Este exemplo remove a política completa de Restrições de Aplicativo do site de Finanças. Ele desabilita a imposição e remove o modo ativo, a lista de permissões e a lista de negações.

Clear-SPOSiteRestrictedAppAccessControlPolicy -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -WhatIf

Este exemplo identifica o site por ID do site e visualiza a alteração sem modificar 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-SPOSiteRestrictedAppAccessControlPolicy -Identity $url -Confirm:$false
Set-SPOSiteRestrictedAppAccessControlMode -Identity $url -Mode Deny
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType DenyList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"
Enable-SPOSiteRestrictedAppAccessControl -Identity $url

Este exemplo remove uma política existente e a recria do zero. Como o modo é removido quando a política é desmarcada, você deve atribuir um modo ao site antes de poder habilitá-lo.

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 confirmar se o site está desconfigurado.

• A limpeza de uma política de site desabilita a imposição, remove o modo ativo e ambas as listas e limpa a política de site armazenada. Um site limpo é indistinguível de um site que nunca foi configurado.
• Para manter a configuração para uso posterior, use-a Disable-SPOSiteRestrictedAppAccessControl . Preserva o modo ativo e ambas as listas.
• Para limpar apenas uma lista, use Clear-SPOSiteRestrictedAppAccessControlList, que preserva a outra lista, o modo ativo e a habilitação do site.
• Após a limpeza, o site não pode ser habilitado até que um modo seja definido. Enable-SPOSiteRestrictedAppAccessControl Falha quando nenhum modo é definido.
• 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.