Get-SPOTenantRestrictedAppAccessControl

Get-SPOTenantRestrictedAppAccessControl

Use el Get-SPOTenantRestrictedAppAccessControl cmdlet para leer la directiva completa de restricciones de aplicaciones de inquilinos de su organizació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.

La directiva de inquilino consta de dos partes:

• Habilitado : el conmutador de cumplimiento maestro para las restricciones de aplicación. Cuando este modificador está desactivado, no se aplican la lista de denegación de inquilinos ni todas las directivas de nivel de sitio. Se conserva la configuración del espacio empresarial y del sitio almacenados. Cuando el conmutador se active de nuevo, la lista de denegación de inquilinos y las directivas de sitio cuya marca de nivel Enabled de sitio sea True reanudar la aplicación con la misma configuración.
• RestrictedAppIds : la lista de denegación de todo el espacio empresarial. Cuando el conmutador está activado, las aplicaciones de esta lista se deniegan y una lista no se puede invalidar mediante una lista de permitidos de nivel de sitio.

La lista de denegación de inquilinos puede contener identificadores de aplicación concretos e identificadores de plano técnico de agente principal. Un id. de plano técnico se aplica a la propia aplicación de plano técnico y a todas las aplicaciones de agente actuales o futuras creadas a partir de ese plano técnico. El cmdlet no requiere que distinga entre los dos: RestrictedAppIds combina las entradas escritas internamente en un archivo Guid[].

Este cmdlet devuelve el estado de directiva autoritativo no almacenado en caché.

Administración de restricciones de aplicaciones de inquilinos está aislada de los cmdlets y Set-SPOTenant de uso Get-SPOTenant general. Restricciones de aplicación no se expone como una Tenant propiedad, por lo que Get-SPOTenant no devuelve la directiva y Set-SPOTenant no puede cambiarla. Use los cmdlets de restricciones de aplicación dedicados que se enumeran en Vínculos relacionados.

Las aplicaciones principales y propias de Microsoft se excluyen de la configuración y el cumplimiento de las restricciones de aplicaciones y nunca aparecen en la lista de denegación de inquilinos.

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.

Get-SPOTenantRestrictedAppAccessControl

En este ejemplo se devuelve la directiva completa de restricciones de aplicaciones de inquilinos, donde se muestra si se habilita la aplicación y qué identificadores de aplicación se encuentran en la lista de denegación de inquilinos.

(Get-SPOTenantRestrictedAppAccessControl).RestrictedAppIds

En este ejemplo solo se devuelven los identificadores de aplicaciones restringidas de la lista de denegación de inquilinos.

$policy = Get-SPOTenantRestrictedAppAccessControl
if (-not $policy.Enabled) {
    Write-Host "Application Restrictions enforcement is off. Site policies aren't enforced."
}

En este ejemplo se almacena la directiva de inquilino en una variable y se comprueba el modificador maestro. Dado que el conmutador de inquilino controla toda la aplicación a nivel de sitio, un conmutador deshabilitado significa que no se está aplicando ninguna directiva de sitio, incluidas las directivas cuya marca a nivel Enabled de sitio es True.

$policy = Get-SPOTenantRestrictedAppAccessControl
if ($policy.Enabled -and $policy.RestrictedAppIds.Count -eq 0) {
    Write-Host "Enforcement is on, but the tenant deny list is empty and denies nothing."
}

En este ejemplo se identifica un conmutador de inquilino habilitado con una lista de denegación de inquilino vacía. Este estado es válido. La lista de denegación de inquilinos no niega nada hasta que se agrega un identificador de aplicación; las directivas de sitio cuya marca True a nivel Enabled de sitio todavía se pueden aplicar.

Devuelve un SPORestrictedAppAccessControlTenantPolicy objeto con las siguientes propiedades.

• El conmutador de inquilino es el conmutador de cumplimiento maestro para las restricciones de aplicación. Al desactivarla, se detiene la aplicación de todas las directivas de sitio cuya marca de nivel Enabled de sitio es True, no solo la lista de denegación de inquilinos.
• Mientras el cambio de inquilino está activado, la lista de denegación de inquilinos tiene prioridad sobre la directiva del sitio y no puede ser invalidada por una lista de permitidos del sitio.
• El ámbito del espacio empresarial es de solo denegación y tiene una sola lista, por lo que no hay ningún modo ni selección de tipo de lista en el ámbito del espacio empresarial.
• La lista de denegación de inquilinos tiene un máximo máximo de 100 identificadores de aplicación.
• La configuración y la habilitación son independientes: cambiar la lista de denegación nunca activa o desactiva el inquilino.
• Se usa Get-SPOSiteRestrictedAppAccessControl para leer la directiva de un sitio individual.