Enable-SPOSiteRestrictedAppAccessControl

Module:
Microsoft.Online.SharePoint.PowerShell Module

Active l’application des restrictions d’application pour un site à l’aide de son mode configuré et de ses listes.

Syntaxe

Default (Par défaut) 

Enable-SPOSiteRestrictedAppAccessControl
    -Identity <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Utilisez l’applet de commande pour activer l’application Enable-SPOSiteRestrictedAppAccessControl des restrictions d’application pour un seul site. Un mode doit déjà être configuré avec Set-SPOSiteRestrictedAppAccessControlMode; l’applet de commande échoue lorsqu’aucun mode n’est défini.

L’application du site est activée uniquement par cette applet de commande. La configuration et l’activation sont indépendantes : les modifications de mode et de liste n’activent jamais l’application. Un administrateur peut organiser une stratégie et Set-SPOSiteRestrictedAppAccessControlModeSet-SPOSiteRestrictedAppAccessControlList l’activer explicitement.

Le mode actif détermine la décision de stratégie de site :

  • 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.

La liste des inactifs est conservée et n’a aucun effet d’exécution.

Le client bascule vers toutes les applications du site. Une stratégie de site n’a aucun effet lorsque le commutateur de client est désactivé et la liste de refus de client ne peut pas être remplacée par une liste verte de site. Utilisez cette fonction Get-SPOTenantRestrictedAppAccessControl pour confirmer le changement de locataire avant de vous appuyer sur une stratégie de site.

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 de Microsoft Entra. Une demande doit passer à la fois le modèle d’autorisation existant et les restrictions d’application.

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. Les restrictions d’application sont entièrement découplées de , donc Get-SPOSite ne charge pas les données de stratégie de SitePropertiessite 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.

Les applications internes et principales de Microsoft sont exclues de la configuration et de l’application des restrictions d’application.

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

Enable-SPOSiteRestrictedAppAccessControl -Identity "https://contoso.sharepoint.com/sites/Finance"

Cet exemple active l’application des restrictions d’application pour le site Finance identifié par son URL. La mise en conformité utilise le mode et les listes déjà configurés sur le site.

Exemple 2

Enable-SPOSiteRestrictedAppAccessControl -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab"

Cet exemple active la mise en œuvre des sanctions pour un site identifié par son ID. Chaque applet de commande Restrictions d’application de site accepte -Identity comme URL de site ou ID de site.

Exemple 3

$url = "https://contoso.sharepoint.com/sites/Finance"
Set-SPOSiteRestrictedAppAccessControlMode -Identity $url -Mode Allow
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"
Enable-SPOSiteRestrictedAppAccessControl -Identity $url

Cet exemple configure un mode et une liste verte, puis active la stratégie explicitement. Les modifications de mode et de liste n’activent pas l’application, de sorte que rien n’est appliqué avant l’exécution de la commande finale. Les applications de la liste verte passent le case activée Restrictions d’application ; 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.

Exemple 4

Enable-SPOSiteRestrictedAppAccessControl -Identity "https://contoso.sharepoint.com/sites/Finance" -Confirm:$false

Cet exemple active la mise en œuvre sans invite de confirmation interactive, pour une utilisation dans l’automatisation. L’utilisation -Confirm:$false ne contourne pas la validation, l’autorisation, l’audit ou la protection interne.

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 à activer. Indiquez 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: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.

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

None

Sorties

None

Cette applet de commande ne renvoie pas d’objet. Utilisez Get-SPOSiteRestrictedAppAccessControl cette fonction pour lire la stratégie résultante.

Notes

  • Cette applet de commande échoue lorsqu’aucun mode n’est configuré sur le site. Définissez le mode sur ou Deny avant l’activation Allow de la stratégie.
  • L’application du site est activée uniquement par cette applet de commande. Les modifications de mode et de liste préservent l’état d’activation actuel.
  • Une liste verte active vide entraîne le refus de toutes les applications tierces et agentiques gouvernées par la stratégie du site. Passez en revue la liste active avec Get-SPOSiteRestrictedAppAccessControl avant d’activer un site.
  • En Deny mode, les applications représentées dans la liste d’exclusion sont refusées par la stratégie de site. Toutes les autres applications gouvernées réussissent la case activée Restrictions d’application.
  • Le commutateur de locataire contrôle toutes les applications du site, de sorte qu’une stratégie de site n’a aucun effet tant que le commutateur de locataire est désactivé. La liste de refus du client ne peut pas être remplacée par une liste verte de sites.
  • Les restrictions d’application n’accordent jamais d’autorisations. Une demande doit toujours transmettre l’autorisation SharePoint existante.
  • Cette applet de commande prend en charge -WhatIf et -Confirm avec ConfirmImpact.High. -Confirm:$false est autorisée pour l’automatisation et n’échappe pas à la validation, à l’autorisation, à l’audit ou à la protection interne.