Enable-SPOSiteRestrictedAppAccessControl

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

Activa la aplicación de restricciones de aplicaciones para un sitio mediante su modo configurado y listas.

Sintaxis

Default (valor predeterminado) 

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

Description

Use el cmdlet para activar la Enable-SPOSiteRestrictedAppAccessControl aplicación de restricciones de aplicaciones para un solo sitio. Un modo ya debe estar configurado con Set-SPOSiteRestrictedAppAccessControlMode; se produce un error en el cmdlet cuando no se establece ningún modo.

Solo este cmdlet activa la obligatoriedad del sitio. La configuración y la habilitación son independientes: los cambios en el modo y la lista nunca activan la obligación. Un administrador puede almacenar provisionalmente una directiva con Set-SPOSiteRestrictedAppAccessControlMode y Set-SPOSiteRestrictedAppAccessControlList luego habilitarla explícitamente.

El modo activo determina la decisión de la directiva del sitio:

  • Permitir : las aplicaciones de la lista de permitidos pasan la comprobación de restricciones de aplicaciones y todas las demás aplicaciones gobernadas son denegadas por la directiva de sitio. Una lista de permitidos activa vacía hace que la directiva de sitio deniegue todas las aplicaciones gubernamentales y de terceros controladas.
  • Denegar : la directiva de sitio deniega las aplicaciones de la lista de denegación y todas las demás aplicaciones gobernadas pasan la comprobación de restricciones de aplicación.

La lista inactiva se conserva y no tiene ningún efecto en tiempo de ejecución.

El conmutador de inquilino controla toda la aplicación del sitio. Una directiva de sitio no tiene ningún efecto mientras el cambio de espacio empresarial está desactivado y una lista de sitios permitidos no puede invalidar la lista de denegación de espacio empresarial. Se usa Get-SPOTenantRestrictedAppAccessControl para confirmar el cambio de inquilino antes de confiar en una directiva de sitio.

Restricciones de aplicación agrega un límite de autorización de SharePoint para las aplicaciones que ya tienen consentimiento de Microsoft Entra y permisos de SharePoint. Nunca concede permisos y no reemplaza el consentimiento de Microsoft Entra. Una solicitud debe pasar tanto el modelo de permisos existente como las restricciones de la aplicación.

La administración de restricciones de aplicación de sitio está aislada de los cmdlets y Set-SPOSite de uso Get-SPOSite general. Las restricciones de aplicación están totalmente desacopladas de , por lo que Get-SPOSite no carga los datos de SitePropertiesdirectivas del sitio y Set-SPOSite no puede cambiarlos. Use los cmdlets de restricciones de aplicación dedicados que se enumeran en Vínculos relacionados.

Las aplicaciones principales y propias de Microsoft están excluidas de la configuración y aplicación de restricciones de aplicaciones.

Para obtener permisos y la información más actual sobre Windows PowerShell para SharePoint Online, consulte la documentación en línea en Introducción a Shell de administración de SharePoint Online.

Ejemplos

Ejemplo 1

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

En este ejemplo se activa la aplicación de restricciones de aplicación para el sitio de finanzas identificado por su dirección URL. El cumplimiento usa el modo y las listas que ya están configurados en el sitio.

Ejemplo 2

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

En este ejemplo se activa la aplicación para un sitio identificado por su identificador. El cmdlet Restricciones de aplicación de cada sitio acepta -Identity como una dirección URL de sitio o un identificador de sitio.

Ejemplo 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

En este ejemplo se configura un modo y una lista de permitidos y, a continuación, se habilita la directiva explícitamente. Los cambios en el modo y la lista no activan la aplicación, por lo que no se aplica nada hasta que se ejecuta el comando final. Las aplicaciones de la lista de permitidos pasan la comprobación de restricciones de aplicaciones; Todas las demás aplicaciones gobernadas están denegadas por la directiva del sitio. El consentimiento existente de Microsoft Entra y la autorización de SharePoint siguen siendo aplicables.

Ejemplo 4

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

En este ejemplo se activa la aplicación sin un aviso de confirmación interactivo, para su uso en automatización. El uso -Confirm:$false no omite la validación, la autorización, la auditoría ni la protección propia.

Parámetros

-Confirm

Aplicable: SharePoint Online

Solicitará confirmación antes de ejecutar el cmdlet. Este cmdlet usa ConfirmImpact.High, por lo que se lo solicita de forma predeterminada. Se usa -Confirm:$false para suprimir la indicación en la automatización.

Propiedades de parámetro

Tipo:System.Management.Automation.SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: SharePoint Online

Especifica el sitio que se va a habilitar. Proporcione la dirección URL del sitio o el identificador de sitio.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: SharePoint Online

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:System.Management.Automation.SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Entradas

None

Salidas

None

Este cmdlet no devuelve un objeto. Se usa Get-SPOSiteRestrictedAppAccessControl para leer la directiva resultante.

Notas

  • Se produce un error en este cmdlet cuando no se configura ningún modo en el sitio. Establezca el modo en Allow o Deny antes de habilitar la directiva.
  • Solo este cmdlet activa la obligatoriedad del sitio. Los cambios de modo y lista conservan el estado de habilitación actual.
  • Una lista de permitidos activa vacía hace que la directiva de sitio deniegue todas las aplicaciones gubernamentales y de terceros controladas. Revise la lista activa con antes de Get-SPOSiteRestrictedAppAccessControl habilitar un sitio.
  • En Deny modo, las aplicaciones representadas en la lista de denegación son denegadas por la directiva de sitio. Todas las demás aplicaciones controladas pasan la comprobación de restricciones de aplicación.
  • El conmutador de inquilino controla toda la aplicación del sitio, de modo que una directiva de sitio no tiene ningún efecto mientras el conmutador de inquilino está desactivado. La lista de denegación de inquilinos no se puede invalidar mediante una lista de sitios permitidos.
  • Las restricciones de aplicación nunca conceden permisos. Una solicitud aún debe pasar la autorización existente de SharePoint.
  • Este cmdlet admite -WhatIf y -Confirm con ConfirmImpact.High. -Confirm:$false permite la automatización y no omite la validación, la autorización, la auditoría ni la protección propia.