Get-SPOTenantRestrictedAppAccessControl

Get-SPOTenantRestrictedAppAccessControl

Utilisez l’applet Get-SPOTenantRestrictedAppAccessControl de commande pour lire la stratégie de restrictions d’application client complète pour votre organisation.

Les restrictions d’application ajoutent une limite d’autorisation SharePoint pour les applications qui ont déjà le consentement de Microsoft Entra et des autorisations SharePoint. Il n’accorde jamais d’autorisations et ne remplace pas le consentement d’Entra. Une demande doit passer à la fois le modèle d’autorisation existant et les restrictions d’application.

La politique de locataire comporte deux parties :

• Activé : commutateur de mise en conformité master pour les restrictions d’application. Lorsque ce commutateur est désactivé, la liste d’exclusion du client et toutes les stratégies au niveau du site ne sont pas appliquées. La configuration du locataire stocké et du site est conservée. Lorsque le commutateur est réactivé, la liste d’exclusion du client et les stratégies de site dont l’indicateur au niveau Enabled du site est True reprennent l’application avec la même configuration.
• RestrictedAppIds : liste d’exclusion à l’échelle du locataire. Lorsque le commutateur est activé, les applications de cette liste sont refusées et la liste ne peut pas être remplacée par une liste verte au niveau du site.

La liste d’exclusion du client peut contenir à la fois des ID d’application concrets et des ID de blueprint d’agent parent. Un ID de blueprint s’applique à l’application de blueprint elle-même et à chaque application agent actuelle ou future créée à partir de ce blueprint. L’applet de commande ne vous oblige pas à faire la distinction entre les deux : RestrictedAppIds fusionne les entrées tapées en interne en une seule version stable et sans Guid[]doublon.

Cette applet de commande retourne l’état de stratégie faisant autorité et non mis en cache.

L’administration des restrictions d’application client est isolée de l’usage Get-SPOTenant général et Set-SPOTenant des applets de commande. Les restrictions d’application ne sont pas exposées en tant que Tenant propriété, elles ne renvoient donc Get-SPOTenant pas la stratégie et Set-SPOTenant ne peuvent pas la modifier. Utilisez les applets de commande dédiées aux restrictions d’application répertoriées dans les liens associés.

Les applications internes et principales de Microsoft sont exclues de la configuration et de l’application des restrictions d’application et n’apparaissent jamais dans la liste des clients refusés.

Pour les autorisations et informations les plus récentes sur Windows PowerShell pour SharePoint Online, consultez la documentation en ligne sur Présentation de SharePoint Online Management Shell.

Get-SPOTenantRestrictedAppAccessControl

Cet exemple retourne la stratégie complète de restrictions d’application du locataire, indiquant si l’application est activée et quels ID d’application se trouvent dans la liste d’exclusion du client.

(Get-SPOTenantRestrictedAppAccessControl).RestrictedAppIds

Cet exemple renvoie uniquement les ID d’application restreints de la liste d’exclusion du locataire.

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

Cet exemple stocke la stratégie de locataire dans une variable et vérifie le commutateur master. Étant donné que le commutateur client contrôle toutes les applications au niveau du site, un commutateur désactivé signifie qu’aucune stratégie de site n’est appliquée, y compris les stratégies dont l’indicateur de niveau Enabled site est 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."
}

Cet exemple identifie un commutateur de locataire activé avec une liste de refus de client vide. Cet état est valide. La liste de refus du client ne refuse rien tant qu’un ID d’application n’est pas ajouté ; Les stratégies de site dont l’indicateur au niveau Enabled du site est True peuvent toujours s’appliquer.

Renvoie un SPORestrictedAppAccessControlTenantPolicy objet avec les propriétés suivantes.

• Le commutateur de locataire est le commutateur de mise en œuvre master pour les restrictions d’application. La désactivation de cette option arrête l’application de chaque stratégie de site dont l’indicateur au niveau Enabled du site est True, et pas seulement la liste d’exclusion du client.
• Lorsque le commutateur de locataire est activé, la liste d’exclusion du client prévaut sur la stratégie du site et ne peut pas être remplacée par une liste verte de sites.
• L’étendue du client est refusée uniquement et comporte une liste unique. Il n’y a donc pas de sélection de mode et de type de liste au niveau de l’étendue du locataire.
• La liste de refus du client ne peut pas contenir plus de 100 ID d’application.
• La configuration et l’activation sont indépendantes : la modification de la liste d’exclusion n’a jamais pour effet d’activer ou de désactiver le commutateur de client.
• Permet Get-SPOSiteRestrictedAppAccessControl de lire la stratégie d’un site particulier.