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 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 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-SPOSiteRestrictedAppAccessControlPolicy para limpar a política de um site individual.