Set-SPOTenantPreAuthSettings

Set-SPOTenantPreAuthSettings
    -IsDisabled <Boolean>
    [<CommonParameters>]

Set-SPOTenantPreAuthSettings
    -Type <TenantPreAuthSettingsListType>
    [-Add]
    [-IncludedApps <String>]
    [-ExcludedApps <String>]
    [-IncludedFeatures <String>]
    [-ExcludedFeatures <String>]
    [<CommonParameters>]

Set-SPOTenantPreAuthSettings
    -Id <String>
    [-Remove]
    [<CommonParameters>]

Mit diesem Cmdlet können Sie das Vorauthentifizierungsfeature in SharePoint Online konfigurieren oder deaktivieren. Die Deaktivierung kann mit Switches kombiniert werden, um eine granulare Vorauthentifizierungsverwaltung für bestimmte Apps und Features auf Mandantenebene zu unterstützen.

Sie müssen SharePoint-Administrator sein, um das Cmdlet ausführen zu können.

Set-SPOTenantPreAuthSettings -IsDisabled $true

Set-SPOTenantPreAuthSettings -Add -Type Allow -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e"

In diesem Beispiel wird die Vorauthentifizierung insgesamt deaktiviert und eine Einstellung hinzugefügt, die es zwei Apps erlaubt, die Vorauthentifizierung für alle Features zu verwenden.

Set-SPOTenantPreAuthSettings -Add -Type Allow -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e" -ExcludedApps "" -IncludedFeatures "" -ExcludedFeatures ""

Dieses Beispiel führt die gleiche Funktion wie in Beispiel 1 aus, außer dass in diesem Fall die Schalter für -ExcludedApps, -IncludedFeatures-ExcludedFeatures , und dem Cmdlet hinzugefügt werden.

Es wird so vermutet, dass diese Schalter den Standardwert "" annehmen, wenn sie nicht mit dem Cmdlet verwendet werden, und Beispiel 2 dient nur zur Veranschaulichung des vollständigen Satzes von Switches.

Set-SPOTenantPreAuthSettings -Remove -Id "368dde6f-c857-4383-a8a7-02a04a294e6d"

In diesem Beispiel wird ein vorhandenes Element aus der aktuellen Liste der Elemente entfernt. Der Entfernungsschalter kann Zulassungs- oder Verweigerungseinträge aus der Liste entfernen.

Set-SPOTenantPreAuthSettings -IsDisabled $true

Set-SPOTenantPreAuthSettings -Add -Type Allow -ExcludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42" -ExcludedFeatures "Download,WebRenderingEmbed"

In diesem Beispiel wird die Vorauthentifizierung insgesamt deaktiviert und für alle Apps außer einer App die Vorauthentifizierung für alle Features mit Ausnahme von "Download" und "WebRenderingEmbed"verwendet.

In diesem Fall wird der App "029e7c27-4b9c-4f8b-ba32-b96249468d42" immer die Verwendung der Vorauthentifizierung verweigert, da sie von der Einstellung für die Zulassungsliste ausgeschlossen ist. Jede andere App darf die Vorauthentifizierung für jedes Feature außer "Download" und "WebRenderingEmbed"verwenden.

Set-SPOTenantPreAuthSettings -IsDisabled $true

Set-SPOTenantPreAuthSettings -Add -Type Allow -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42" -IncludedFeatures "OfficeOnline,WebRenderingEmbed,Download"

Set-SPOTenantPreAuthSettings -Add -Type Deny -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e"

Dieses Beispiel deaktiviert die Vorauthentifizierung insgesamt, enthält jedoch eine Überschneidung zwischen den Einstellungen in der Zulassungsliste und der Verweigerungsliste. Sie ermöglicht einer App zunächst die Verwendung der Vorauthentifizierung für die "OfficeOnline"Features , "WebRenderingEmbed", und "Download" . In der endgültigen Ausführung des Cmdlets wird jedoch verhindert, dass dieselbe App die Vorauthentifizierung für alle Features verwendet.

In diesem Fall darf die App "029e7c27-4b9c-4f8b-ba32-b96249468d42" trotz der Einstellung keine Vorauthentifizierung für eines der in der Zulassungsliste aufgeführten Features verwenden. Dies liegt daran, dass die Verweigerungsliste Vorrang vor der Zulassungsliste hat.

Set-SPOTenantPreAuthSettings -IsDisabled $false

Set-SPOTenantPreAuthSettings -Add -Type Deny -IncludedApps "Empty"

Dieses Beispiel aktiviert die Vorauthentifizierung insgesamt und verweigert Anforderungen, die nicht von einer App stammen (z. B. Anforderungen über einen Browser), die Verwendung der Vorauthentifizierung für alle Features.

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.

-ExcludedFeatures Verwenden Sie -IncludedFeatures Featurenamen aus der folgenden Tabelle. Es wird explizit erwähnt, ob das Feature defekt ist, wenn es über das PowerShell-Cmdlet deaktiviert wird.