Set-SPOSiteRestrictedAppAccessControlMode

Module:
Microsoft.Online.SharePoint.PowerShell Module

Définit le mode actif de la stratégie de restrictions d’application au niveau du site sur Allow ou Deny, en préservant l’activation du site et les deux listes.

Syntaxe

Default (Par défaut) 

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

Description

Utilisez l’applet de commande pour modifier la Set-SPOSiteRestrictedAppAccessControlMode liste qu’un site applique. Cette applet de commande modifie uniquement le mode actif. Elle conserve l’activation du site, ainsi que les listes verte et interdite.

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.

Le mode actif sélectionne la liste qui est appliquée :

  • Autoriser : les applications de la liste verte réussissent le case activée Restrictions des applications et toutes les autres applications régies sont refusées par la stratégie de site. Une liste verte active vide entraîne le refus de toutes les applications tierces et agentiques gouvernées par la stratégie du site.
  • Refuser : les applications figurant dans la liste d’exclusion sont refusées par la stratégie de site, et toutes les autres applications gouvernées réussissent la case activée Restrictions d’application. Une liste d’exclusion active vide signifie que la stratégie de site n’en refuse aucune.

Les deux listes sont toujours stockées et peuvent être gérées quel que soit le mode actif. Seule la liste sélectionnée par le mode actif participe à la mise en œuvre au moment de l’exécution. La liste des inactifs est conservée pour les modifications de mode ultérieures et n’a aucun effet d’exécution. Un mode doit être explicitement configuré avant que la stratégie de site puisse être activée.

Étant donné qu’un commutateur de mode peut modifier la décision effective pour toutes les applications gouvernées sur le site, l’applet de commande affiche un avertissement avant d’effectuer la modification. L’avertissement identifie le mode actuel, le mode cible, la taille de la liste conservée nouvellement active et la nouvelle décision par défaut, et il indique clairement que les deux listes sont conservées. L’applet de commande vous demande ensuite de confirmer. Permet -WhatIf d’afficher le même impact sans modifier la stratégie.

La configuration et l’activation sont orthogonales : un changement de mode n’active jamais l’application. La mise en œuvre du site n’est activée que par Enable-SPOSiteRestrictedAppAccessControl, afin que vous puissiez mettre en place un mode et des listes, puis activer le site explicitement. La seule combinaison rejetée par le backend est activée avec le mode None.

L’application du site est également contrôlée par le commutateur de locataire. Lorsque le commutateur de locataire est activé, la liste d’exclusion du client prévaut et ne peut pas être remplacée par une liste verte de site.

L’automatisation peut utiliser la norme -Confirm:$false. La suppression de l’invite n’empêche pas la validation, l’autorisation, l’audit ou la protection interne.

L’administration des restrictions d’application de site est isolée de l’usage Get-SPOSite général et Set-SPOSite des applets de commande. Get-SPOSite Ne charge pas les données de stratégie de site et Set-SPOSite ne peut pas les modifier. Utilisez les applets de commande dédiées aux restrictions d’application répertoriées dans les liens associé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.

Exemples

Exemple 1

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

Cet exemple définit le mode actif du site Finance sur Allow. Les applications de la liste verte du site réussissent la case activée des restrictions d’application, et toutes les autres applications régies sont refusées par la stratégie de site. Le consentement Microsoft Microsoft Entra et l’autorisation SharePoint existants s’appliquent toujours. La liste d’exclusion est conservée mais devient inactive. L’applet de commande affiche l’avertissement de changement de mode et demande une confirmation avant d’appliquer la modification.

Exemple 2

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

Cet exemple illustre l’impact du basculement du site Finance vers Deny, y compris le mode actuel, le mode cible, la taille de la liste de refus nouvellement active et la nouvelle décision par défaut, sans modifier la stratégie.

Exemple 3

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

Cet exemple bascule un site identifié par son ID en site sans invite, pour Deny une utilisation dans l’automatisation. La suppression de l’invite n’empêche pas la validation, l’autorisation, l’audit ou la protection interne.

Exemple 4

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

Cet exemple décrit d’abord le mode, puis active explicitement l’application. Un changement de mode n’active jamais l’application par lui-même.

Paramètres

-Confirm

Applicable : SharePoint Online

Une invite de confirmation apparaît avant d’exécuter le cmdlet. Cette applet de commande utilise ConfirmImpact.High, donc elle vous invite par défaut. Permet -Confirm:$false de supprimer l’invite dans l’automatisation.

Propriétés du paramètre

Type:System.Management.Automation.SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : SharePoint Online

Spécifie le site à configurer. Vous pouvez spécifier l’URL ou l’ID du site.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Mode

Applicable : SharePoint Online

Spécifie le mode actif de la stratégie de site. Les valeurs valides sont Allow et Deny.

Lorsque le mode est Allow, les applications de la liste verte réussissent le case activée Restrictions d’application et toutes les autres applications gouvernées sont refusées par la stratégie de site. Lorsque le mode est Deny, les applications de la liste d’exclusion sont refusées par la stratégie de site et toutes les autres applications gouvernées réussissent la case activée Restrictions d’application. Les deux listes sont conservées dans les deux cas. Le consentement Microsoft Microsoft Entra et l’autorisation SharePoint existants s’appliquent toujours.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Valeurs acceptées:Allow, Deny
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : SharePoint Online

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande n’est pas exécutée. -WhatIf Affiche le même impact de changement de mode que l’avertissement de confirmation sans modifier la stratégie.

Propriétés du paramètre

Type:System.Management.Automation.SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

System.String

Sorties

None

Notes

  • Un changement de mode modifie uniquement le mode actif. Elle préserve l’activation du site et les deux listes.
  • Avant le basculement, l’applet de commande avertit avec le mode actuel, le mode cible, la taille de la liste conservée nouvellement active et la nouvelle décision par défaut.
  • L’avertissement indique que les deux listes sont conservées et l’applet de commande demande une confirmation.
  • Une liste verte active vide entraîne le refus de toutes les applications tierces et agentiques gouvernées par la stratégie du site. Une liste d’exclusion active vide signifie que la stratégie de site n’en refuse aucune. Le consentement Microsoft Microsoft Entra et l’autorisation SharePoint existants s’appliquent toujours.
  • La configuration et l’activation sont orthogonales. L’application du site est activée uniquement par Enable-SPOSiteRestrictedAppAccessControl. La seule combinaison rejetée par le backend est activée avec le mode None.
  • Le client bascule vers toutes les applications du site. Lorsque le commutateur de locataire est activé, la liste de refus du client ne peut pas être remplacée par une liste verte de site.
  • Permet Get-SPOSiteRestrictedAppAccessControl de confirmer le mode obtenu et les deux listes.