Enable-SPOSiteRestrictedAppAccessControl

Módulo:
Microsoft.Online.SharePoint.PowerShell Module

Ativa a imposição de restrições de aplicativo para um site usando seu modo configurado e listas.

Sintaxe

Default (Default) 

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

Description

Use o cmdlet para ativar a imposição de Restrições de Enable-SPOSiteRestrictedAppAccessControl Aplicativo para um único site. Um modo já deve estar configurado com Set-SPOSiteRestrictedAppAccessControlMode; o cmdlet falha quando nenhum modo é definido.

A imposição do site é ativada somente por este cmdlet. A configuração e a habilitação são independentes: as alterações de modo e lista nunca ativam a imposição. Um administrador pode preparar uma política com Set-SPOSiteRestrictedAppAccessControlMode a e Set-SPOSiteRestrictedAppAccessControlList depois habilitá-la explicitamente.

O modo ativo determina a decisão da política do site:

  • Permitir - os aplicativos na lista de permissões passam na marca de Restrições de Aplicativos e todos os outros aplicativos controlados são negados pela política do site. Uma lista de permissões ativa vazia faz com que a política do site negue todos os aplicativos controlados de terceiros e agenciados.
  • Negar - os aplicativos na lista de negações são negados pela política do site e todos os outros aplicativos controlados passam na marca de Restrições de Aplicativo.

A lista inativa é preservada e não tem efeito de runtime.

A opção de locatário bloqueia toda a imposição do site. Uma política de site não tem efeito enquanto a opção de locatário está desativada e a lista de negação de locatário não pode ser substituída por uma lista de permissões de site. Use Get-SPOTenantRestrictedAppAccessControl para confirmar a opção de locatário antes de confiar em uma política de 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 Microsoft Entra. Uma solicitação deve passar pelo modelo de permissão existente e pelas Restrições de Aplicativo.

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.

Os aplicativos primários e principais da Microsoft são excluídos da configuração e aplicação de Restrições de Aplicativo.

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

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

Este exemplo ativa a imposição de Restrições de Aplicativo para o site de Finanças identificado por sua URL. A imposição usa o modo e as listas que já estão configuradas no site.

Exemplo 2

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

Este exemplo ativa a imposição de um site identificado por sua ID. Cada cmdlet de Restrições de Aplicativo do site aceita -Identity como uma URL do site ou uma ID do site.

Exemplo 3

$url = "https://contoso.sharepoint.com/sites/Finance"
Set-SPOSiteRestrictedAppAccessControlMode -Identity $url -Mode Allow
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"
Enable-SPOSiteRestrictedAppAccessControl -Identity $url

Este exemplo configura um modo e uma lista de permissões e, em seguida, habilita a política explicitamente. As alterações de modo e lista não ativam a imposição, portanto, nada é imposto até que o comando final seja executado. Os aplicativos na lista de permissões passam pela marca de Restrições de Aplicativo; todos os outros aplicativos controlados são negados pela política do site. O consentimento existente do Microsoft Entra e a autorização do SharePoint ainda se aplicam.

Exemplo 4

Enable-SPOSiteRestrictedAppAccessControl -Identity "https://contoso.sharepoint.com/sites/Finance" -Confirm:$false

Este exemplo ativa a imposição sem um prompt de confirmação interativo, para uso em automação. O uso -Confirm:$false 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.

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

-Identity

Aplicável: SharePoint Online

Especifica o site a ser habilitado. Forneça a URL do site ou a ID do site.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
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

Este cmdlet não retorna um objeto. Use Get-SPOSiteRestrictedAppAccessControl para ler a política resultante.

Observações

  • Este cmdlet falha quando nenhum modo é configurado no site. Defina o modo para Allow ou Deny antes de habilitar a política.
  • A imposição do site é ativada somente por este cmdlet. As alterações de modo e lista preservam o estado de ativação atual.
  • Uma lista de permissões ativa vazia faz com que a política do site negue todos os aplicativos controlados de terceiros e agenciados. Examine a lista ativa antes Get-SPOSiteRestrictedAppAccessControl de habilitar um site.
  • No Deny modo, os aplicativos representados na lista de negações são negados pela política do site. Todos os outros aplicativos controlados passaram na marca de Restrições de Aplicativo.
  • 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.