Clear-SPOTenantRestrictedAppAccessControlPolicy
Desativa a opção de imposição de restrições de aplicativo do locatário e limpa a lista de negações em todo o locatário.
Sintaxe
Default (Default)
Clear-SPOTenantRestrictedAppAccessControlPolicy
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use o Clear-SPOTenantRestrictedAppAccessControlPolicy cmdlet para redefinir a política de Restrições de Aplicativo do locatário. O cmdlet desabilita a opção de imposição do locatário e limpa a lista de negações em todo o locatário em uma operação.
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.
A troca de locatário bloqueia a lista de negação de locatário e toda a imposição no nível do site. Desativá-lo interrompe a imposição de todas as políticas de site cujo sinalizador no nível Enabled do site seja True, não apenas a lista de negações de locatário. O cmdlet avisa sobre esse efeito antes da confirmação.
O escopo do locatário é somente negação com uma única lista, portanto, não há nenhum cmdlet de lista clara separado. Para esvaziar a lista de negações enquanto mantém o switch de locatário ativado para políticas de site habilitadas, remova suas IDs de aplicativo com Set-SPOTenantRestrictedAppAccessControlList. Use Clear-SPOTenantRestrictedAppAccessControlPolicy para remover totalmente a política de locatário.
Use este cmdlet quando quiser remover totalmente a configuração do locatário. Se você quiser interromper a imposição, mas manter a lista de negações para mais tarde, use Disable-SPOTenantRestrictedAppAccessControl . Se você quiser remover apenas as IDs de aplicativo selecionadas, use Set-SPOTenantRestrictedAppAccessControlList com -RemoveRestrictedAppIds.
A remoção de IDs não requer o Microsoft Graph, portanto, aplicativos obsoletos ou excluídos na lista de negações de locatário são limpos junto com o restante da lista.
Restrições de Aplicativos de Locatário administração é isolada do uso Get-SPOTenant geral e Set-SPOTenant cmdlets. As restrições do aplicativo não são expostas como uma Tenant propriedade, portanto Get-SPOTenant , não retornam a política e Set-SPOTenant não podem alterá-la.
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
Clear-SPOTenantRestrictedAppAccessControlPolicy
Este exemplo desativa a opção de imposição de locatário e limpa a lista de negação de locatário. O cmdlet avisa que isso também interrompe a imposição de todas as políticas de site cujo sinalizador no nível Enabled do site seja True, e solicita confirmação.
Exemplo 2
Clear-SPOTenantRestrictedAppAccessControlPolicy -WhatIf
Este exemplo mostra o que aconteceria se a política de locatário fosse limpa, sem alterar a política de locatário armazenada.
Exemplo 3
Get-SPOTenantRestrictedAppAccessControl
Clear-SPOTenantRestrictedAppAccessControlPolicy -Confirm:$false
Get-SPOTenantRestrictedAppAccessControl
Este exemplo lê a política de locatário atual, limpa-a sem solicitar confirmação e lê a política novamente para confirmar se Enabled está False vazia RestrictedAppIds . Suprimir o prompt não ignora a validação, autorização, auditoria ou proteção de terceiros.
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. Suprimir o prompt não ignora a validação, autorização, auditoria ou proteção de terceiros.
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 |
-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
None
Saídas
None
Esse cmdlet não retorna um objeto de saída. Use Get-SPOTenantRestrictedAppAccessControl para confirmar a política de locatário resultante.
Observações
- Esse cmdlet desabilita a opção de locatário e limpa a lista de negação de locatário. Para interromper a imposição, preservando a lista de negações, use
Disable-SPOTenantRestrictedAppAccessControl. - A troca de locatário bloqueia a lista de negação de locatário e toda a imposição no nível do site. Desativá-lo interrompe a imposição de todas as políticas de site cujo sinalizador no nível
Enableddo site sejaTrue, não apenas a lista de negações de locatário. O cmdlet avisa sobre esse efeito antes da confirmação. - O escopo do locatário é somente negação com uma única lista, portanto, não há nenhum cmdlet de lista não criptografada separado no escopo do locatário.
- A limpeza não chama o Microsoft Graph, portanto, as IDs de aplicativos obsoletas ou excluídas são removidas com o restante da lista.
- Esse cmdlet não remove a configuração da política do site. Use
Clear-SPOSiteRestrictedAppAccessControlPolicypara limpar a política de um site individual.