Clear-SPOSiteRestrictedAppAccessControlList

Clear-SPOSiteRestrictedAppAccessControlList
    -Identity <String>
    -ListType <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Use el Clear-SPOSiteRestrictedAppAccessControlList cmdlet para borrar la lista de permitidos o la lista de denegación en un solo sitio. Al borrar una lista, se conserva la habilitación de la otra lista, el modo activo y el sitio. Para quitar la directiva completa, use Clear-SPOSiteRestrictedAppAccessControlPolicy.

Un sitio almacena ambas listas, pero solo la lista seleccionada por el modo activo participa en la aplicación:

• El modo Allow aplica la lista de permitidos. Las aplicaciones enumeradas pasan la comprobación de restricciones de aplicaciones y todas las demás aplicaciones gobernadas están denegadas por la directiva de sitio.
• El modo de denegación aplica la lista de denegación. La directiva de sitio deniega las aplicaciones enumeradas y todas las demás aplicaciones gobernadas pasan la comprobación de restricciones de aplicación.

Cuando la lista borrada es la que aplica el modo activo, el cmdlet emite una advertencia antes de la confirmación. Borrar la lista de permitidos activa hace que la directiva del sitio deniegue todas las aplicaciones de terceros y agenciac controladas. Borrar la lista de denegación activa significa que la directiva de sitio ya no niega ninguna aplicación gobernada. Esta advertencia describe solo la decisión de directiva Restricciones de aplicaciones y nunca significa que se conceda acceso a una aplicación. El consentimiento existente de Microsoft Entra y la autorización de SharePoint siguen siendo aplicables. La advertencia también indica si el cambio surte efecto inmediatamente o cuando se habilite la aplicación a continuación.

Borrar una lista inactiva no cambia la aplicación actual, pero sigue siendo compatible con -WhatIf y -Confirm, y se audita.

La configuración y la habilitación son ortogonales. Los cambios en las listas nunca activan el cumplimiento, por lo que borrar una lista en un sitio que no está habilitado deja el sitio deshabilitado y prepara el cambio para la próxima vez que se habilite el cumplimiento con Enable-SPOSiteRestrictedAppAccessControl. Esto evita el peligroso caso en el que agregar un único identificador a un sitio sin configurar activaría inmediatamente una lista de permitidos y bloquearía todas las demás aplicaciones.

El conmutador de inquilino controla toda la aplicación del sitio. Una directiva de sitio no tiene ningún efecto mientras el conmutador de inquilino está desactivado y una lista de permitidos del sitio no puede invalidar la lista de denegación de inquilinos, por lo que borrar una lista de denegación del sitio nunca restaura el acceso para una aplicación que el inquilino deniega.

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.

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.

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.

Clear-SPOSiteRestrictedAppAccessControlList -Identity "https://contoso.sharepoint.com/sites/Finance" -ListType DenyList

Este ejemplo borra la lista de denegación en el sitio de Finanzas. Conserva la lista de permitidos, el modo activo y la habilitación del sitio. Si Deny es el modo activo, el cmdlet advierte de que la directiva de sitio ya no deniega las aplicaciones gobernadas en esa lista. El consentimiento existente de Microsoft Entra y la autorización de SharePoint siguen siendo aplicables.

Clear-SPOSiteRestrictedAppAccessControlList -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -ListType AllowList -WhatIf

En este ejemplo se identifica el sitio por identificador de sitio y se obtiene una vista previa borrando la lista de permitidos sin cambiar la directiva. El cmdlet Restricciones de aplicación de cada sitio acepta -Identity como una dirección URL de sitio o un identificador de sitio.

$url = "https://contoso.sharepoint.com/sites/Finance"
Clear-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"

En este ejemplo se vuelve a generar una lista de permitidos desde cero. Dado que los cambios en la lista son solo de configuración, ninguno de los comandos cambia si el sitio está habilitado.

Clear-SPOSiteRestrictedAppAccessControlList -Identity "https://contoso.sharepoint.com/sites/Finance" -ListType DenyList -Confirm:$false

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

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.

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

• Al borrar una lista, se conserva la otra lista, el modo activo y la habilitación del sitio.
• Al borrar la lista que aplica el modo activo, se cambia la decisión de directiva sobre restricciones de aplicació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. El cmdlet avisa antes de la confirmación y establece si el cambio surte efecto inmediatamente o cuando se habilite la aplicación a continuación.
• Borrar una lista inactiva no cambia la aplicación actual, pero la operación sigue siendo compatible -WhatIf y -Confirm es auditada.
• Los cambios en una lista nunca activan la obligación. La aplicación del sitio solo está activada por Enable-SPOSiteRestrictedAppAccessControl.
• 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.