Disable-SPOSiteRestrictedAppAccessControl

Disable-SPOSiteRestrictedAppAccessControl
    -Identity <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Use o cmdlet para desativar a Disable-SPOSiteRestrictedAppAccessControl imposição de Restrições de Aplicativo para um único site, preservando o modo ativo e ambas as listas. Você pode reabilitar a mesma configuração mais tarde com Enable-SPOSiteRestrictedAppAccessControl.

Desabilitar um site é diferente de limpá-lo. Para remover o modo e ambas as listas e limpar totalmente a política de site armazenada, use Clear-SPOSiteRestrictedAppAccessControlPolicy.

A configuração e a ativação são ortogonais. As alterações de modo e lista nunca ativam a imposição, portanto, depois de desabilitar um site, você pode continuar a preparar as alterações com Set-SPOSiteRestrictedAppAccessControlMode e Set-SPOSiteRestrictedAppAccessControlList sem reativar a imposição. A imposição do site é ativada apenas por Enable-SPOSiteRestrictedAppAccessControl.

Enquanto o site estiver desabilitado, nenhuma decisão de Restrições de Aplicativo no nível do site se aplicará às solicitações para esse site. A política no nível do locatário não é afetada: a opção de locatário bloqueia toda a imposição do site e a lista de negação do locatário não pode ser substituída por uma lista de permissões do site.

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, desabilitar uma política de 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..

Disable-SPOSiteRestrictedAppAccessControl -Identity "https://contoso.sharepoint.com/sites/Finance"

Este exemplo desativa a imposição de Restrições de Aplicativo para o site de Finanças. O modo ativo, a lista de permissões e a lista de negações são preservados.

Disable-SPOSiteRestrictedAppAccessControl -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -WhatIf

Este exemplo usa uma ID de site e mostra o que aconteceria 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"
Disable-SPOSiteRestrictedAppAccessControl -Identity $url -Confirm:$false
Get-SPOSiteRestrictedAppAccessControl -Identity $url

Este exemplo desabilita a imposição sem um prompt interativo e, em seguida, lê a política de volta para confirmar se o modo e ambas as listas ainda estão armazenados. 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.

• A desabilitação preserva o modo ativo e ambas as listas. Use Clear-SPOSiteRestrictedAppAccessControlPolicy para remover o modo e as listas e limpar a política de site armazenada.
• A imposição do site é ativada novamente apenas por Enable-SPOSiteRestrictedAppAccessControl. As alterações de modo e lista nunca ativam a imposição.
• 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.