Set-SPOTenantRestrictedAppAccessControlList

Set-SPOTenantRestrictedAppAccessControlList
    [-AddRestrictedAppIds <Guid[]>]
    [-RemoveRestrictedAppIds <Guid[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Use o Set-SPOTenantRestrictedAppAccessControlList cmdlet para alterar a lista de negações em todo o locatário para Restrições de Aplicativo.

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.

Ambos os parâmetros são aplicados em uma atualização atômica que preserva a opção de imposição do locatário. Pelo menos um de -AddRestrictedAppIds ou -RemoveRestrictedAppIds é necessário, e a mesma ID não pode aparecer em ambos os parâmetros. As remoções são aplicadas antes das adições.

Você fornece apenas IDs de aplicativo. Você não identifica se uma ID é um aplicativo regular ou um blueprint de agente pai: o back-end classifica cada ID adicionada e a armazena na lista interna apropriada. Uma ID de blueprint de agente pai na lista de negações de locatário bloqueia o próprio aplicativo de blueprint e cada aplicativo de agente atual ou futuro criado a partir desse blueprint.

As IDs adicionadas são classificadas usando o Microsoft Graph. Os aplicativos próprios e principais da Microsoft e IDs que não podem ser classificados são rejeitados. Um acréscimo em massa é tudo ou nada: se qualquer ID fornecida for rejeitada, nenhuma ID será mantida. As remoções não usam o Microsoft Graph, portanto, IDs de aplicativos obsoletas ou excluídas sempre podem ser removidas.

A lista combinada 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 ortogonais: as alterações de lista nunca ativam ou desativam a opção do locatário. Use Enable-SPOTenantRestrictedAppAccessControl e Disable-SPOTenantRestrictedAppAccessControl altere a imposição.

A remoção da última entrada deixa um switch habilitado com uma lista de negações vazia, que não nega nada. Esse estado é permitido porque é legítimo durante a limpeza, mas o cmdlet avisa e aponta para Disable-SPOTenantRestrictedAppAccessControl ou Clear-SPOTenantRestrictedAppAccessControlPolicy para desativar explicitamente as Restrições de Aplicativo.

O escopo do locatário é somente negação e tem uma única lista, portanto, não há nenhum cmdlet de modo, nenhum -ListType parâmetro e nenhum cmdlet de lista clara separado.

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

Set-SPOTenantRestrictedAppAccessControlList -AddRestrictedAppIds 11111111-1111-1111-1111-111111111111

Este exemplo adiciona uma ID de aplicativo à lista de negações de locatário. O back-end classifica a ID e a armazena como um aplicativo regular ou um blueprint de agente pai. A opção de imposição do locatário não foi alterada.

Set-SPOTenantRestrictedAppAccessControlList -AddRestrictedAppIds 11111111-1111-1111-1111-111111111111, 22222222-2222-2222-2222-222222222222 -RemoveRestrictedAppIds 33333333-3333-3333-3333-333333333333

Este exemplo adiciona duas IDs de aplicativo e remove uma terceira em uma única atualização atômica. A remoção é aplicada antes das adições. Se a ID adicionada for um aplicativo primário ou principal ou não puder ser classificada, a operação concluída falhará e nada será mantido.

Set-SPOTenantRestrictedAppAccessControlList -RemoveRestrictedAppIds 33333333-3333-3333-3333-333333333333 -Confirm:$false

Este exemplo remove uma ID de aplicativo sem solicitar confirmação, o que é útil na automação. As remoções não chamam o Microsoft Graph, portanto, uma ID para um aplicativo excluído ou obsoleto ainda pode ser removida. Suprimir o prompt não ignora a validação, autorização, auditoria ou proteção de terceiros.

Set-SPOTenantRestrictedAppAccessControlList -AddRestrictedAppIds 44444444-4444-4444-4444-444444444444 -WhatIf

Este exemplo mostra o que aconteceria se a ID do aplicativo fosse adicionada, sem alterar a política de locatário armazenada.

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.

Esse cmdlet não retorna um objeto de saída. Use Get-SPOTenantRestrictedAppAccessControl para ler a política de locatário resultante.

• Adiciona e remove são aplicados como uma atualização atômica. As remoções são aplicadas antes das adições.
• Uma adição em massa é tudo ou nada. Se qualquer ID fornecida for um aplicativo primário ou principal ou não puder ser classificada, nenhuma ID será mantida.
• A lista combinada de negações de locatários tem um máximo rígido de 100 IDs de aplicativo.
• O administrador fornece apenas IDs. O back-end classifica cada ID adicionada e as armazena como um aplicativo regular ou um blueprint de agente pai.
• Uma ID de blueprint de agente pai bloqueia o aplicativo de blueprint e todos os aplicativos de agente atuais ou futuros criados a partir dele.
• A configuração e a habilitação são ortogonais: as alterações de lista nunca acionam a opção do locatário.
• A remoção da última entrada deixa uma opção habilitada com uma lista de negações vazia que não nega nada. O cmdlet avisa e aponta para Disable-SPOTenantRestrictedAppAccessControl ou Clear-SPOTenantRestrictedAppAccessControlPolicy.
• Use Set-SPOSiteRestrictedAppAccessControlList para alterar as listas de um site individual.