Clear-SPOSiteRestrictedAppAccessControlList

Clear-SPOSiteRestrictedAppAccessControlList
    -Identity <String>
    -ListType <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Utilisez l’applet Clear-SPOSiteRestrictedAppAccessControlList de commande pour effacer la liste verte ou la liste d’exclusion d’un seul site. L’effacement d’une liste conserve l’autre liste, le mode actif et l’activation de site. Pour supprimer la stratégie complète, utilisez Clear-SPOSiteRestrictedAppAccessControlPolicy.

Un site stocke les deux listes, mais seule la liste sélectionnée par le mode actif participe à la mise en œuvre :

• Le mode autoriser applique la liste verte. Les applications répertoriées réussissent la vérification des restrictions d’application, et toutes les autres applications gouvernées sont refusées par la stratégie de site.
• Le mode Refuser applique la liste d’exclusion. Les applications répertoriées sont refusées par la stratégie de site, et toutes les autres applications gouvernées réussissent la vérification des restrictions d’application.

Lorsque la liste effacée est celle que le mode actif applique, l’applet de commande émet un avertissement avant confirmation. L’effacement de la liste verte active entraîne le refus par la stratégie de site de toutes les applications régies, tierces et agentiques. L’effacement de la liste d’exclusion active signifie que la stratégie de site ne refuse plus aucune application gouvernée. Cet avertissement décrit uniquement la décision de stratégie relative aux restrictions d’application et ne signifie jamais qu’une application se voit accorder l’accès. Le consentement Microsoft Entra et l’autorisation SharePoint existants s’appliquent toujours. L’avertissement indique également si la modification prend effet immédiatement ou lors de la prochaine activation de l’application.

La suppression d’une liste inactive ne modifie pas la mise en œuvre actuelle, mais elle prend toujours en charge -WhatIf et -Confirm, et elle est auditée.

La configuration et l’activation sont orthogonales. Les modifications de liste ne sont jamais activées. Par conséquent, la suppression d’une liste sur un site qui n’est pas activé laisse le site désactivé et la modification est transférée pour la prochaine fois que l’application est activée avec Enable-SPOSiteRestrictedAppAccessControl. Cela évite le cas dangereux où l’ajout d’un ID unique à un site non configuré activerait immédiatement une liste verte et bloquerait toutes les autres applications.

Le client bascule vers toutes les applications du site. Une stratégie de site n’a aucun effet tant que le commutateur de client est désactivé et la liste de refus du client ne peut pas être remplacée par une liste verte de sites. Ainsi, l’effacement d’une liste de refus de site ne restaure jamais l’accès à une application que le client refuse.

Les restrictions d’application ajoutent une limite d’autorisation SharePoint pour les applications qui disposent déjà du 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.

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.

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.

Clear-SPOSiteRestrictedAppAccessControlList -Identity "https://contoso.sharepoint.com/sites/Finance" -ListType DenyList

Cet exemple efface la liste d’exclusion du site Finance. Elle préserve la liste verte, le mode actif et l’activation de site. Si Deny est le mode actif, l’applet de commande vous avertit que la stratégie de site ne refuse plus les applications régies dans cette liste. Le consentement Microsoft Entra et l’autorisation SharePoint existants s’appliquent toujours.

Clear-SPOSiteRestrictedAppAccessControlList -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -ListType AllowList -WhatIf

Cet exemple identifie le site par ID de site et affiche des aperçus en effaçant la liste verte sans modifier la stratégie. Chaque applet de commande Restrictions d’application de site accepte -Identity comme URL de site ou ID de site.

$url = "https://contoso.sharepoint.com/sites/Finance"
Clear-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"

Cet exemple reconstruit une liste verte à partir de zéro. Étant donné que les modifications de liste sont uniquement liées à la configuration, aucune des commandes ne modifie l’activation du site.

Clear-SPOSiteRestrictedAppAccessControlList -Identity "https://contoso.sharepoint.com/sites/Finance" -ListType DenyList -Confirm:$false

Cet exemple efface la liste d’exclusion sans invite de confirmation interactive, pour une utilisation dans Automation. L’utilisation -Confirm:$false ne contourne pas la validation, l’autorisation, l’audit ou la protection interne.

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.

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

• L’effacement d’une liste conserve l’autre liste, le mode actif et l’activation du site.
• L’effacement de la liste que le mode actif applique modifie la décision de stratégie relative aux restrictions d’application. 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 Entra et l’autorisation SharePoint existants s’appliquent toujours. L’applet de commande avertit avant la confirmation et indique si la modification prend effet immédiatement ou lors de la prochaine activation de l’application.
• La suppression d’une liste inactive ne modifie pas la mise en œuvre actuelle, mais l’opération prend toujours en charge -WhatIf et -Confirm est auditée.
• Les modifications de liste ne sont jamais activées. L’application du site est activée uniquement par Enable-SPOSiteRestrictedAppAccessControl.
• 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.