Set-SPOSiteRestrictedAppAccessControlMode

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

Establece el modo activo de la directiva de restricciones de aplicaciones a nivel de sitio en Allow o Deny, conservando la habilitación del sitio y ambas listas.

Sintaxis

Default (valor predeterminado) 

Set-SPOSiteRestrictedAppAccessControlMode
    [-Identity] <String>
    -Mode <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Use el cmdlet para cambiar la Set-SPOSiteRestrictedAppAccessControlMode lista que aplica un sitio. Este cmdlet solo cambia el modo activo. Conserva la habilitación del sitio y tanto la lista de permitidos como la lista de denegación.

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 Entra. Una solicitud debe pasar tanto el modelo de permisos existente como las restricciones de la aplicación.

El modo activo selecciona la lista que se aplica:

  • 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. Una lista de denegación activa vacía significa que la directiva de sitio no niega ninguna de ellas.

Ambas listas siempre se almacenan y se pueden administrar independientemente del modo que esté activo. Solo la lista seleccionada por el modo activo participa en la aplicación del tiempo de ejecución. La lista de inactivos se conserva para futuros cambios de modo y no tiene ningún efecto en tiempo de ejecución. Se debe configurar explícitamente un modo para poder habilitar la directiva de sitio.

Dado que un cambio de modo puede cambiar la decisión efectiva para cada aplicación gobernada en el sitio, el cmdlet muestra una advertencia antes de realizar el cambio. La advertencia identifica el modo actual, el modo de destino, el tamaño de la lista conservada activa recientemente y la nueva decisión predeterminada, e indica claramente que se conservan ambas listas. A continuación, el cmdlet le pide que confirme. Se usa -WhatIf para mostrar el mismo impacto sin cambiar la directiva.

La configuración y la habilitación son ortogonales: un cambio de modo nunca activa la obligación. Solo se activa la aplicación del sitio mediante Enable-SPOSiteRestrictedAppAccessControl, por lo que puede organizar un modo y listas y, a continuación, habilitar el sitio explícitamente. La única combinación que el back-end rechaza está habilitada con mode None.

El conmutador de inquilino también controla la aplicación del sitio. Mientras el cambio de inquilino está activado, la lista de denegación de inquilinos tiene prioridad y no puede ser invalidada por una lista de permitidos del sitio.

La automatización puede usar el estándar -Confirm:$false. Suprimir el mensaje no omite la validación, la autorización, la auditoría o la protección propia.

La administración de restricciones de aplicación de sitio está aislada de los cmdlets y Set-SPOSite de uso Get-SPOSite general. Get-SPOSite No carga los datos de la directiva del sitio y Set-SPOSite no se pueden cambiar. Use los cmdlets de restricciones de aplicación dedicados que se enumeran en Vínculos relacionados.

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

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow

En este ejemplo se establece el modo activo del sitio Finanzas en Allow. Las aplicaciones de la lista de permitidos del sitio pasan la comprobación de restricciones de aplicaciones y todas las demás aplicaciones gobernadas son denegadas por la directiva del sitio. El consentimiento existente de Microsoft Entra y la autorización de SharePoint siguen siendo aplicables. La lista de denegación se conserva, pero pasa a estar inactiva. El cmdlet muestra la advertencia del cambio de modo y pide confirmación antes de aplicar el cambio.

Ejemplo 2

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Deny -WhatIf

En este ejemplo se muestra el impacto de cambiar el sitio Finanzas a Deny, incluido el modo actual, el modo de destino, el tamaño de la lista de denegación nueva activa y la nueva decisión predeterminada, sin cambiar la directiva.

Ejemplo 3

Set-SPOSiteRestrictedAppAccessControlMode -Identity 8a1e30f6-2f52-4b9e-9d1b-2e9f6c1d40aa -Mode Deny -Confirm:$false

En este ejemplo se cambia un sitio identificado por su id. sin Deny pedir confirmación, para su uso en la automatización. Suprimir el mensaje no omite la validación, la autorización, la auditoría o la protección propia.

Ejemplo 4

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow
Enable-SPOSiteRestrictedAppAccessControl -Identity https://contoso.sharepoint.com/sites/Finance

En este ejemplo se almacena provisionalmente el modo en primer lugar y, a continuación, se activa explícitamente la aplicación. Un cambio de modo nunca activa la aplicación por sí mismo.

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 configurar. Puede especificar la dirección URL del sitio o el identificador del 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:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Mode

Aplicable: SharePoint Online

Especifica el modo activo de la directiva de sitio. Los valores válidos son Allow y Deny.

Cuando el modo es Allow, 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. Cuando el modo es Deny, 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. Ambas listas se conservan de cualquier manera. El consentimiento existente de Microsoft Entra y la autorización de SharePoint siguen siendo aplicables.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Valores aceptados:Allow, Deny
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. -WhatIf Muestra el mismo impacto del cambio de modo que la advertencia de confirmación sin cambiar la directiva.

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

System.String

Salidas

None

Notas

  • Un cambio de modo cambia solo el modo activo. Conserva la habilitación del sitio y ambas listas.
  • Antes del cambio, el cmdlet advierte con el modo actual, el modo de destino, el tamaño de la lista conservada recién activa y la nueva decisión predeterminada.
  • La advertencia indica que ambas listas se conservan y el cmdlet pide confirmación.
  • Una lista de permitidos activa vacía hace que la directiva de sitio deniegue todas las aplicaciones gubernamentales y de terceros controladas. Una lista de denegación activa vacía significa que la directiva de sitio no niega ninguna de ellas. El consentimiento existente de Microsoft Entra y la autorización de SharePoint siguen siendo aplicables.
  • La configuración y la habilitación son ortogonales. La aplicación del sitio solo está activada por Enable-SPOSiteRestrictedAppAccessControl. La única combinación que el back-end rechaza está habilitada con mode None.
  • El conmutador de inquilino controla toda la aplicación del sitio. Mientras el cambio de inquilino esté activado, la lista de denegación de inquilinos no se puede invalidar mediante una lista de permitidos del sitio.
  • Se usa Get-SPOSiteRestrictedAppAccessControl para confirmar el modo resultante y ambas listas.