Disable-SPOSiteRestrictedAppAccessControl

Modul:
Microsoft.Online.SharePoint.PowerShell Module

Deaktiviert die Erzwingung von Anwendungseinschränkungen für eine Website, wobei der aktive Modus und beide Listen beibehalten werden.

Syntax

Default (Standard) 

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

Beschreibung

Verwenden Sie das Disable-SPOSiteRestrictedAppAccessControl Cmdlet, um die Erzwingung von Anwendungsbeschränkungen für eine einzelne Website zu deaktivieren, während der aktive Modus und beide Listen beibehalten werden. Sie können die gleiche Konfiguration später mit Enable-SPOSiteRestrictedAppAccessControlaktivieren.

Das Deaktivieren einer Website unterscheidet sich von deren Löschung. Um den Modus und beide Listen zu entfernen und die gespeicherte Websiterichtlinie vollständig zu löschen, verwenden Sie Clear-SPOSiteRestrictedAppAccessControlPolicy.

Konfiguration und Aktivierung sind orthogonal. Modus- und Listenänderungen aktivieren nie die Erzwingung. Daher können Sie nach dem Deaktivieren einer Website weiterhin Änderungen mit Set-SPOSiteRestrictedAppAccessControlMode und Set-SPOSiteRestrictedAppAccessControlList ohne erneute Aktivierung der Erzwingung vornehmen. Die Websiteerzwingung kann nur durch aktiviert werden Enable-SPOSiteRestrictedAppAccessControl.

Solange die Website deaktiviert ist, gilt für Anforderungen für diese Website keine Entscheidung über Anwendungseinschränkungen auf Standortebene. Richtlinie auf Mandantenebene ist nicht betroffen: Der Mandantenschalter steuert die gesamte Site-Erzwingung ab, und die Mandantenverweigerungsliste kann nicht durch eine Websitezulassungsliste außer Kraft gesetzt werden.

"Anwendungseinschränkungen" fügt eine SharePoint-Autorisierungsgrenze für Anwendungen hinzu, die bereits über Microsoft Entra-Zustimmung und SharePoint-Berechtigungen verfügen. Sie erteilt niemals Berechtigungen und ersetzt nicht die Zustimmung von Entra. Eine Anforderung muss sowohl das vorhandene Berechtigungsmodell als auch Anwendungseinschränkungen erfüllen, sodass durch das Deaktivieren einer Websiterichtlinie kein Anwendungszugriff gewährt wird, über den nicht bereits verfügt.

Die Verwaltung von Site-Anwendungseinschränkungen ist isoliert von allgemeinen und Get-SPOSiteSet-SPOSite Cmdlets. "Anwendungseinschränkungen" ist vollständig von entkoppelt SiteProperties, lädt also Get-SPOSite keine Websiterichtliniendaten und Set-SPOSite kann diese nicht ändern. Verwenden Sie die dedizierten Cmdlets für Anwendungseinschränkungen, die unter "Verwandte Links" aufgeführt sind.

Angaben zu Berechtigungen sowie die aktuellsten Informationen zu Windows PowerShell für SharePoint Online finden Sie in der Onlinedokumentation unter Einführung in die SharePoint Online-Verwaltungsshell.

Beispiele

Beispiel 1

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

In diesem Beispiel wird die Erzwingung von Anwendungsbeschränkungen für die Finanzwebsite deaktiviert. Der aktive Modus, die Zulassungsliste und die Verweigerungsliste werden beibehalten.

Beispiel 2

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

In diesem Beispiel wird eine Website-ID verwendet und gezeigt, was ohne Änderung der Richtlinie passieren würde. Jedes Cmdlet für Anwendungseinschränkungen für Websites akzeptiert -Identity es entweder als Website-URL oder als Website-ID.

Beispiel 3

$url = "https://contoso.sharepoint.com/sites/Finance"
Disable-SPOSiteRestrictedAppAccessControl -Identity $url -Confirm:$false
Get-SPOSiteRestrictedAppAccessControl -Identity $url

Dieses Beispiel deaktiviert die Erzwingung ohne interaktive Eingabeaufforderung und liest dann die Richtlinie zurück, um zu bestätigen, dass der Modus und beide Listen weiterhin gespeichert sind. Bei der Verwendung -Confirm:$false werden die Validierung, Autorisierung, Überwachung oder der Erstanbieterschutz nicht umgangen.

Parameter

-Confirm

Anwendbar: SharePoint Online

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf. In diesem Cmdlet wird ConfirmImpact.Highverwendet, sodass standardmäßig eine Eingabeaufforderung angezeigt wird. Wird verwendet -Confirm:$false , um die Eingabeaufforderung in der Automatisierung zu unterdrücken.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:cf

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Identity

Anwendbar: SharePoint Online

Gibt die zu deaktivierende Website an. Geben Sie entweder die Website-URL oder die Website-ID an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Anwendbar: SharePoint Online

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Eingaben

None

Ausgaben

None

Dieses Cmdlet gibt kein Objekt zurück. Wird verwendet Get-SPOSiteRestrictedAppAccessControl , um die resultierende Richtlinie zu lesen.

Hinweise

  • Durch das Deaktivieren werden der aktive Modus und beide Listen beibehalten. Wird verwendet Clear-SPOSiteRestrictedAppAccessControlPolicy , um den Modus und die Listen zu entfernen und die gespeicherte Websiterichtlinie zu löschen.
  • Die Websiteerzwingung wird erst durch Enable-SPOSiteRestrictedAppAccessControl. Modus- und Listenänderungen aktivieren niemals die Erzwingung.
  • Der Mandantenschalter steuert die gesamte Standorterzwingung, sodass eine Standortrichtlinie keine Auswirkungen hat, während der Mandantenwechsel deaktiviert ist. Die Verweigerungsliste des Mandanten kann nicht durch eine Websitezulassungsliste außer Kraft gesetzt werden.
  • Anwendungseinschränkungen gewähren niemals Berechtigungen. Eine Anforderung muss weiterhin die vorhandene SharePoint-Autorisierung bestehen.
  • Dieses Cmdlet unterstützt -WhatIf und -Confirm mit ConfirmImpact.High. -Confirm:$false ist für die Automatisierung zulässig und umgeht weder die Validierung, Autorisierung, Überwachung noch den Erstanbieterschutz.