Set-SPOSiteRestrictedAppAccessControlMode

Modul:
Microsoft.Online.SharePoint.PowerShell Module

Legt den aktiven Modus der Richtlinie für Anwendungseinschränkungen auf Standortebene auf Allow oder Denyfest, wobei die Websiteaktivierung und beide Listen beibehalten werden.

Syntax

Default (Standard) 

Set-SPOSiteRestrictedAppAccessControlMode
    [-Identity] <String>
    -Mode <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Verwenden Sie das Set-SPOSiteRestrictedAppAccessControlMode Cmdlet, um zu ändern, welche Liste eine Website erzwingt. Dieses Cmdlet ändert nur den aktiven Modus. Die Aktivierung der Website und die Zulassungsliste und die Verweigerungsliste werden beibehalten.

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

Der aktive Modus wählt die Liste aus, die erzwungen wird:

  • 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. Eine leere aktive Verweigerungsliste bedeutet, dass die Websiterichtlinie keine von ihnen ablehnt.

Beide Listen werden immer gespeichert und können unabhängig davon verwaltet werden, welcher Modus aktiv ist. Nur die vom aktiven Modus ausgewählte Liste nimmt an der Laufzeiterzwingung teil. Die Liste der inaktiven Benutzer bleibt für künftige Modusänderungen erhalten und hat keine Auswirkungen auf die Laufzeit. Ein Modus muss explizit konfiguriert werden, bevor die Websiterichtlinie aktiviert werden kann.

Da ein Moduswechsel die effektive Entscheidung für jede gesteuerte Anwendung auf der Website ändern kann, zeigt das Cmdlet eine Warnung an, bevor die Änderung vorgenommen wird. Die Warnung identifiziert den aktuellen Modus, den Zielmodus, die Größe der neu aktiven beibehaltenen Liste und die neue Standardentscheidung, und es wird eindeutig angegeben, dass beide Listen beibehalten werden. Das Cmdlet fordert Sie dann zur Bestätigung auf. Verwenden Sie diese Option -WhatIf , um dieselbe Auswirkung anzuzeigen, ohne die Richtlinie zu ändern.

Konfiguration und Aktivierung sind orthogonal: Eine Modusänderung aktiviert niemals die Erzwingung. Die Erzwingung der Website wird nur durch Enable-SPOSiteRestrictedAppAccessControlaktiviert, sodass Sie einen Modus und Listen bereitstellen und die Website dann explizit aktivieren können. Die einzige Kombination, die das Back-End ablehnt, ist mit Modus Noneaktiviert.

Die Erzwingung von Websites wird auch durch den Mandantenwechsel gesteuert. Während der Mandantenwechsel aktiviert ist, hat die Mandantenverweigerungsliste Vorrang und kann nicht durch eine Websitezulassungsliste außer Kraft gesetzt werden.

Die Automatisierung kann den Standard -Confirm:$false. Durch das Unterdrücken der Eingabeaufforderung werden die Überprüfung, Autorisierung, Überwachung oder der Erstanbieterschutz nicht umgangen.

Die Verwaltung von Site-Anwendungseinschränkungen ist isoliert von allgemeinen und Get-SPOSiteSet-SPOSite Cmdlets. Get-SPOSite lädt 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

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow

In diesem Beispiel wird der aktive Modus der Finanzwebsite auf Allowfestgelegt. Anwendungen in der Liste zugelassener Anwendungen bestehen die Überprüfung der Anwendungseinschränkungen, und alle anderen gesteuerten Anwendungen werden von der Websiterichtlinie abgelehnt. Vorhandene Microsoft Entra-Zustimmung und SharePoint-Autorisierung gelten weiterhin. Die Verweigerungsliste bleibt erhalten, wird aber inaktiv. Das Cmdlet zeigt die Warnung zum Moduswechsel an und fordert eine Bestätigung an, bevor die Änderung angewendet wird.

Beispiel 2

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Deny -WhatIf

Dieses Beispiel zeigt die Auswirkungen des Wechsels der Finanzwebsite zu Deny, einschließlich des aktuellen Modus, des Zielmodus, der Größe der neu aktiven Verweigerungsliste und der neuen Standardentscheidung, ohne die Richtlinie zu ändern.

Beispiel 3

Set-SPOSiteRestrictedAppAccessControlMode -Identity 8a1e30f6-2f52-4b9e-9d1b-2e9f6c1d40aa -Mode Deny -Confirm:$false

In diesem Beispiel wird eine durch ihre ID identifizierte Website ohne Aufforderung zur Verwendung in der Automatisierung umgeschaltet Deny . Durch das Unterdrücken der Eingabeaufforderung werden die Überprüfung, Autorisierung, Überwachung oder der Erstanbieterschutz nicht umgangen.

Beispiel 4

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow
Enable-SPOSiteRestrictedAppAccessControl -Identity https://contoso.sharepoint.com/sites/Finance

In diesem Beispiel wird der Modus zuerst gestaffelt und dann die Erzwingung explizit aktiviert. Eine Modusänderung aktiviert die Erzwingung nie von selbst.

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 den zu konfigurierenden Standort an. Sie können entweder die Website-URL oder die Website-ID angeben.

Parametereigenschaften

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

Parametersätze

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

-Mode

Anwendbar: SharePoint Online

Gibt den aktiven Modus der Websiterichtlinie an. Gültige Werte sind Allow und Deny.

Wenn der Modus ist Allow, bestehen Anwendungen in der Zulassungsliste die Überprüfung der Anwendungseinschränkungen, und alle anderen gesteuerten Anwendungen werden von der Websiterichtlinie abgelehnt. Wenn der Modus ist Deny, werden Anwendungen in der Verweigerungsliste von der Standortrichtlinie abgelehnt, und alle anderen gesteuerten Anwendungen bestehen die Prüfung auf Anwendungseinschränkungen. Beide Listen bleiben so oder so erhalten. Vorhandene Microsoft Entra-Zustimmung und SharePoint-Autorisierung gelten weiterhin.

Parametereigenschaften

Typ:System.String
Standardwert:None
Zulässige Werte:Allow, Deny
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. -WhatIf Zeigt die gleiche Auswirkung des Modusschalters wie bei der Bestätigungswarnung an, ohne die Richtlinie zu ändern.

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

System.String

Ausgaben

None

Hinweise

  • Eine Modusänderung ändert nur den aktiven Modus. Die Aktivierung der Website und beide Listen werden beibehalten.
  • Vor dem Wechsel warnt das Cmdlet mit dem aktuellen Modus, dem Zielmodus, der Größe der neu aktiven beibehaltenen Liste und der neuen Standardentscheidung.
  • Die Warnung besagt, dass beide Listen beibehalten werden, und das Cmdlet fordert zur Bestätigung auf.
  • Eine leere aktive Zulassungsliste führt dazu, dass die Websiterichtlinie alle gesteuerten Anwendungen von Drittanbietern und Agenten ablehnt. Eine leere aktive Verweigerungsliste bedeutet, dass die Websiterichtlinie keine von ihnen ablehnt. Vorhandene Microsoft Entra-Zustimmung und SharePoint-Autorisierung gelten weiterhin.
  • Konfiguration und Aktivierung sind orthogonal. Die Websiteerzwingung kann nur durch aktiviert werden Enable-SPOSiteRestrictedAppAccessControl. Die einzige Kombination, die das Back-End ablehnt, ist mit Modus Noneaktiviert.
  • Der Mandantenschalter führt alle Standorterzwingungsgates. Während der Mandantenwechsel aktiviert ist, kann die Verweigerungsliste des Mandanten nicht durch eine Websitezulassungsliste außer Kraft gesetzt werden.
  • Verwenden Sie diese Option Get-SPOSiteRestrictedAppAccessControl , um den resultierenden Modus und beide Listen zu bestätigen.