Enable-SPOSiteRestrictedAppAccessControl

Modul:
Microsoft.Online.SharePoint.PowerShell Module

Aktiviert die Erzwingung von Anwendungseinschränkungen für eine Website mit dem konfigurierten Modus und den konfigurierten Listen.

Syntax

Default (Standard) 

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

Beschreibung

Verwenden Sie das Enable-SPOSiteRestrictedAppAccessControl Cmdlet, um die Erzwingung von Anwendungsbeschränkungen für eine einzelne Site zu aktivieren. Ein Modus muss bereits mit Set-SPOSiteRestrictedAppAccessControlModekonfiguriert sein. Das Cmdlet schlägt fehl, wenn kein Modus festgelegt ist.

Die Websiteerzwingung wird nur durch dieses Cmdlet aktiviert. Konfiguration und Aktivierung sind unabhängig: Modus- und Listenänderungen aktivieren niemals die Erzwingung. Ein Administrator kann eine Richtlinie mit Set-SPOSiteRestrictedAppAccessControlMode und Set-SPOSiteRestrictedAppAccessControlList bereitstellen und sie dann explizit aktivieren.

Der aktive Modus bestimmt die Entscheidung der Websiterichtlinie:

  • Zulassen : Anwendungen in der Zulassungsliste bestehen die Überprüfung auf Anwendungseinschränkungen, und alle anderen gesteuerten Anwendungen werden von der Websiterichtlinie abgelehnt. Eine leere aktive Zulassungsliste führt dazu, dass die Websiterichtlinie alle gesteuerten Anwendungen von Drittanbietern und Agenten ablehnt.
  • Verweigern : Anwendungen in der Verweigerungsliste werden von der Siterichtlinie abgelehnt, und alle anderen verwalteten Anwendungen bestehen die Prüfung der Anwendungsbeschränkungen.

Die inaktive Liste wird beibehalten und hat keine Auswirkungen auf die Laufzeit.

Der Mandantenschalter führt alle Standorterzwingungsgates. Eine Websiterichtlinie hat keine Wirkung, solange der Mandantenschalter deaktiviert ist, und die Mandantenverweigerungsliste kann nicht durch eine Websitezulassungsliste außer Kraft gesetzt werden. Wird verwendet Get-SPOTenantRestrictedAppAccessControl , um den Mandantenwechsel zu bestätigen, bevor Sie sich auf eine Standortrichtlinie verlassen.

"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 Microsoft Entra. Eine Anforderung muss sowohl das vorhandene Berechtigungsmodell als auch Anwendungseinschränkungen erfüllen.

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.

Microsoft-Erstanbieter- und Core-Anwendungen sind von der Konfiguration und Durchsetzung von Anwendungsbeschränkungen ausgeschlossen.

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

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

In diesem Beispiel wird die Erzwingung von Anwendungseinschränkungen für die Finanzwebsite aktiviert, die durch ihre URL identifiziert wird. Die Erzwingung verwendet den Modus und die Listen, die bereits auf der Website konfiguriert sind.

Beispiel 2

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

In diesem Beispiel wird die Erzwingung für eine Website aktiviert, die durch ihre ID identifiziert wird. 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"
Set-SPOSiteRestrictedAppAccessControlMode -Identity $url -Mode Allow
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"
Enable-SPOSiteRestrictedAppAccessControl -Identity $url

In diesem Beispiel werden ein Modus und eine Zulassungsliste konfiguriert und die Richtlinie dann explizit aktiviert. Die Modus- und Listenänderungen aktivieren die Erzwingung nicht, sodass nichts erzwungen wird, bis der letzte Befehl ausgeführt wird. Anwendungen in der Zulassungsliste bestehen die Prüfung auf Anwendungsbeschränkungen. Alle anderen gesteuerten Anwendungen werden durch die Websiterichtlinie abgelehnt. Vorhandene Microsoft Entra-Zustimmung und SharePoint-Autorisierung gelten weiterhin.

Beispiel 4

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

Dieses Beispiel aktiviert die Erzwingung ohne interaktive Bestätigungsaufforderung zur Verwendung in der Automatisierung. 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 aktivierende 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

  • Dieses Cmdlet schlägt fehl, wenn auf der Website kein Modus konfiguriert ist. Legen Sie den Modus auf Allow oder Deny vor dem Aktivieren der Richtlinie fest.
  • Die Websiteerzwingung wird nur durch dieses Cmdlet aktiviert. Modus- und Listenänderungen behalten den aktuellen Aktivierungsstatus bei.
  • Eine leere aktive Zulassungsliste führt dazu, dass die Websiterichtlinie alle gesteuerten Anwendungen von Drittanbietern und Agenten ablehnt. Überprüfen Sie die aktive Liste Get-SPOSiteRestrictedAppAccessControl , bevor Sie eine Website aktivieren.
  • Im Deny Modus werden Anwendungen, die in der Verweigerungsliste dargestellt sind, von der Websiterichtlinie abgelehnt. Alle anderen gesteuerten Anwendungen bestehen die Prüfung der Anwendungseinschränkungen.
  • 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.