Clear-SPOSiteRestrictedAppAccessControlPolicy

Clear-SPOSiteRestrictedAppAccessControlPolicy
    -Identity <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Utilisez l’applet de commande pour rétablir l’état non configuré d’un Clear-SPOSiteRestrictedAppAccessControlPolicy site. L’applet de commande désactive l’application, supprime le mode actif et les deux listes, et efface la stratégie de site stocké. Une fois la stratégie effacée, le site est dans le même état qu’un site qui n’a jamais été configuré : la mise en œuvre est désactivée et il n’y a aucune entrée.

L’effacement est différent de la désactivation. Disable-SPOSiteRestrictedAppAccessControl désactive la mise en conformité, mais conserve le mode actif et les deux listes afin que la même configuration puisse être réactivée ultérieurement. À utiliser Clear-SPOSiteRestrictedAppAccessControlPolicy lorsque vous souhaitez également supprimer la configuration. Pour effacer une seule liste et conserver l’autre liste, le mode et l’activation de site, utilisez Clear-SPOSiteRestrictedAppAccessControlList.

Étant donné que le mode est supprimé en même temps que les listes, un site effacé ne peut pas être réactivé tant qu’un mode n’est pas défini. Enable-SPOSiteRestrictedAppAccessControl échoue lorsqu’aucun mode n’est défini ; Enabled with Mode None est la seule combinaison rejetée par le serveur principal. Reconstruisez la stratégie avec Set-SPOSiteRestrictedAppAccessControlMode et Set-SPOSiteRestrictedAppAccessControlList, puis activez-la explicitement. La configuration et l’activation sont orthogonales : les modifications de mode et de liste n’activent jamais l’application, de sorte qu’un administrateur peut organiser une stratégie, puis l’activer. 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.

L’effacement d’une stratégie de site affecte uniquement ce site. Le commutateur de locataire fait référence à toutes les applications de site et la liste de refus du client ne peut pas être remplacée par une liste verte de sites. Ainsi, l’effacement d’une stratégie de site ne restaure jamais l’accès à une application que le client refuse. Utilisez Clear-SPOTenantRestrictedAppAccessControlPolicy pour l’étendue du locataire.

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 à la fois passer le modèle d’autorisation existant et les restrictions d’application, de sorte que l’effacement d’une stratégie de site n’accorde pas à une application l’accès qu’elle n’a pas déjà.

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-SPOSiteRestrictedAppAccessControlPolicy -Identity "https://contoso.sharepoint.com/sites/Finance"

Cet exemple supprime la stratégie complète des restrictions d’application du site Finance. Il désactive la mise en œuvre et supprime le mode actif, la liste verte et la liste interdite.

Clear-SPOSiteRestrictedAppAccessControlPolicy -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -WhatIf

Cet exemple identifie le site par ID de site et affiche un aperçu de la modification 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-SPOSiteRestrictedAppAccessControlPolicy -Identity $url -Confirm:$false
Set-SPOSiteRestrictedAppAccessControlMode -Identity $url -Mode Deny
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType DenyList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"
Enable-SPOSiteRestrictedAppAccessControl -Identity $url

Cet exemple supprime une stratégie existante, puis la régénère à partir de zéro. Étant donné que le mode est supprimé lorsque la stratégie est effacée, vous devez affecter un mode au site avant de pouvoir l’activer.

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 cette fonction Get-SPOSiteRestrictedAppAccessControl pour confirmer que le site n’est pas configuré.

• L’effacement d’une stratégie de site désactive l’application, supprime le mode actif et les deux listes, et efface la stratégie de site stockée. Un site effacé est impossible à distinguer d’un site qui n’a jamais été configuré.
• Pour conserver la configuration pour une utilisation ultérieure, utilisez Disable-SPOSiteRestrictedAppAccessControl plutôt. Elle préserve le mode actif et les deux listes.
• Pour effacer une seule liste, utilisez Clear-SPOSiteRestrictedAppAccessControlList, qui conserve l’autre liste, le mode actif et l’activation du site.
• Après l’effacement, le site ne peut pas être activé tant qu’un mode n’est pas défini. Enable-SPOSiteRestrictedAppAccessControl échoue lorsqu’aucun mode n’est défini.
• 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.