Clear-SPOSiteRestrictedAppAccessControlPolicy

Clear-SPOSiteRestrictedAppAccessControlPolicy
    -Identity <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Use el Clear-SPOSiteRestrictedAppAccessControlPolicy cmdlet para devolver un sitio a su estado no configurado. El cmdlet deshabilita la aplicación, quita el modo activo y ambas listas, y borra la directiva de sitio almacenada. Después de borrar la directiva, el sitio se encuentra en el mismo estado que un sitio que nunca se configuró: la aplicación está deshabilitada y no hay entradas.

La limpieza es diferente de la deshabilitación. Disable-SPOSiteRestrictedAppAccessControl Desactiva la aplicación, pero conserva el modo activo y ambas listas para que se pueda volver a habilitar la misma configuración más adelante. Úsalo Clear-SPOSiteRestrictedAppAccessControlPolicy también cuando quieras quitar la configuración. Para borrar solo una lista y mantener la otra, el modo y la habilitación del sitio, use Clear-SPOSiteRestrictedAppAccessControlList.

Debido a que el modo se quita junto con las listas, un sitio borrado no se puede volver a habilitar hasta que se establezca un modo. Enable-SPOSiteRestrictedAppAccessControl falla cuando no se establece ningún modo; Habilitado con MODO None es la única combinación que rechaza el back-end. Vuelva a generar la directiva con Set-SPOSiteRestrictedAppAccessControlMode y Set-SPOSiteRestrictedAppAccessControlListy, a continuación, habilítela explícitamente. La configuración y la habilitación son ortogonales: los cambios en el modo y la lista nunca activan la obligación, por lo que un administrador puede preparar una directiva y, a continuación, habilitarla. 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.

Borrar una directiva de sitio solo afecta a ese sitio. El conmutador de inquilino controla toda la aplicación del sitio, y una lista de permitidos de sitio no puede invalidar la lista de denegación de inquilinos, por lo que borrar una directiva de sitio nunca restaura el acceso para una aplicación que el inquilino deniega. Se usa Clear-SPOTenantRestrictedAppAccessControlPolicy para el ámbito de inquilino.

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 aplicación, por lo que borrar una directiva de sitio no concede a ninguna aplicación acceso que aún no tenga.

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-SPOSiteRestrictedAppAccessControlPolicy -Identity "https://contoso.sharepoint.com/sites/Finance"

En este ejemplo se elimina la directiva completa de Restricciones de aplicación del sitio de Finanzas. Deshabilita la aplicación y quita el modo activo, la lista de permitidos y la lista de denegados.

Clear-SPOSiteRestrictedAppAccessControlPolicy -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -WhatIf

En este ejemplo se identifica el sitio por identificador de sitio y se obtiene una vista previa del cambio sin modificar 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-SPOSiteRestrictedAppAccessControlPolicy -Identity $url -Confirm:$false
Set-SPOSiteRestrictedAppAccessControlMode -Identity $url -Mode Deny
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType DenyList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"
Enable-SPOSiteRestrictedAppAccessControl -Identity $url

En este ejemplo se quita una directiva existente y, a continuación, se vuelve a generar desde cero. Dado que el modo se quita cuando se borra la directiva, debe asignar un modo al sitio para poder habilitarlo.

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. Utilícela Get-SPOSiteRestrictedAppAccessControl para confirmar que el sitio no está configurado.

• Al borrar una directiva de sitio, se deshabilita la aplicación, se quita el modo activo y ambas listas, y se borra la directiva de sitio almacenada. Un sitio borrado es indistinguible de un sitio que nunca se configuró.
• Para conservar la configuración para su uso posterior, use Disable-SPOSiteRestrictedAppAccessControl en su lugar. Conserva el modo activo y ambas listas.
• Para borrar solo una lista, use Clear-SPOSiteRestrictedAppAccessControlList, que conserva la otra lista, el modo activo y la habilitación del sitio.
• Después de la limpieza, el sitio no se puede habilitar hasta que se establezca un modo. Enable-SPOSiteRestrictedAppAccessControl Se produce un error cuando no se establece ningún modo.
• 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.