Get-SPOTenantRestrictedAppAccessControl

Get-SPOTenantRestrictedAppAccessControl

Use o cmdlet para ler a política completa de Restrições de Aplicativos de Get-SPOTenantRestrictedAppAccessControl locatário para sua organizaçã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 política de locatário tem duas partes:

• Habilitado - a opção de imposição master para Restrições de Aplicativo. Quando essa opção está desativada, a lista de negação de locatário e todas as políticas no nível do site não são impostas. A configuração armazenada do locatário e do site é preservada. Quando a opção é ativada novamente, a lista de negações de locatários e as políticas de site cujo sinalizador no nível Enabled do site é True retomar a imposição com a mesma configuração.
• RestrictedAppIds - a lista de negações em todo o locatário. Quando a opção está ativada, os aplicativos nesta lista são negados e a lista não pode ser substituída por uma lista de permissões no nível do site.

A lista de negações de locatário pode conter IDs de aplicativo concretas e IDs de blueprint de agente pai. Uma ID de blueprint se aplica ao próprio aplicativo de blueprint e a cada aplicativo de agente atual ou futuro criado a partir desse blueprint. O cmdlet não exige que você distinga entre os dois: RestrictedAppIds mescla as entradas digitadas internamente em um arquivo .Guid[]

Esse cmdlet retorna o estado da política autoritativa e não armazenada em cache.

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. Use os cmdlets de Restrições de Aplicativos dedicados listados em Links Relacionados.

Os aplicativos próprios e principais da Microsoft são excluídos da configuração e aplicação de Restrições de Aplicativo e nunca aparecem na lista de negação de locatário.

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..

Get-SPOTenantRestrictedAppAccessControl

Este exemplo retorna a política completa de Restrições de Aplicativos do locatário, mostrando se a imposição está habilitada e quais IDs de aplicativo estão na lista de negações de locatários.

(Get-SPOTenantRestrictedAppAccessControl).RestrictedAppIds

Este exemplo retorna apenas as IDs de aplicativo restritas da lista de negações de locatário.

$policy = Get-SPOTenantRestrictedAppAccessControl
if (-not $policy.Enabled) {
    Write-Host "Application Restrictions enforcement is off. Site policies aren't enforced."
}

Este exemplo armazena a política de locatário em uma variável e verifica a opção master. Como o comutador de locatário bloqueia toda a imposição no nível do site, um comutador desabilitado significa que nenhuma política do site está sendo imposta, incluindo políticas cujo sinalizador no nível Enabled do site é True.

$policy = Get-SPOTenantRestrictedAppAccessControl
if ($policy.Enabled -and $policy.RestrictedAppIds.Count -eq 0) {
    Write-Host "Enforcement is on, but the tenant deny list is empty and denies nothing."
}

Este exemplo identifica uma opção de locatário habilitada com uma lista de negações de locatário vazia. Este estado é válido. A lista de negações do locatário não nega nada até que uma ID do aplicativo seja adicionada; políticas de site cujo sinalizador no nível Enabled do site é True ainda podem ser aplicadas.

Retorna um SPORestrictedAppAccessControlTenantPolicy objeto com as propriedades a seguir.

• O comutador de locatário é o comutador de imposição master para Restrições de Aplicativo. 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.
• Enquanto a opção de locatário estiver ativada, a lista de negação de locatário tem precedência sobre a política do site e não pode ser substituída por uma lista de permissões do site.
• O escopo do locatário é somente de negação e tem uma única lista, portanto, não há nenhum modo e nenhuma seleção de tipo de lista no escopo do locatário.
• A lista de negações de locatários tem um máximo rígido de 100 IDs de aplicativo.
• A configuração e a habilitação são independentes: alterar a lista de negações nunca ativa ou desativa a opção do locatário.
• Use Get-SPOSiteRestrictedAppAccessControl para ler a política de um site individual.