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>]

Sie können dieses Cmdlet verwenden, um das Vorauthentifizierungsfeature in SharePoint Online zu konfigurieren oder zu deaktivieren. Die Deaktivierung kann mit Schaltern kombiniert werden, um eine präzise Vorauthentifizierungsverwaltung für bestimmte Apps und Features auf Mandantenebene zu unterstützen.

Sie müssen ein 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, mit der zwei Apps die Vorauthentifizierung für alle Features verwenden können.

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

In diesem Beispiel wird dieselbe Funktion wie in Beispiel 1 ausgeführt, mit der Ausnahme, dass in diesem Fall die Schalter für -ExcludedApps, -IncludedFeaturesund -ExcludedFeatures dem Cmdlet hinzugefügt werden.

Es wird davon ausgegangen, dass diese Schalter den Standardwert von "" übernehmen, wenn sie nicht mit dem Cmdlet verwendet werden, und Beispiel 2 wird verwendet, um nur den vollständigen Satz von Schaltern zu veranschaulichen.

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

In diesem Beispiel wird ein vorhandenes Element aus der aktuellen Elementliste entfernt. Der Remove-Schalter kann Zulassungs- oder Ablehnungseinträ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 ermöglicht es allen Apps außer einer, die Vorauthentifizierung für alle Features mit Ausnahme von "Download" und "WebRenderingEmbed"zu verwenden.

In diesem Fall wird der App "029e7c27-4b9c-4f8b-ba32-b96249468d42" die Verwendung der Vorauthentifizierung immer verweigert, da sie von der Einstellung der 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"

In diesem Beispiel wird die Vorauthentifizierung insgesamt deaktiviert, enthält jedoch eine Überlappung zwischen den Einstellungen in der Zulassungsliste und der Ablehnungsliste. Zunächst kann eine App die Vorauthentifizierung für die "OfficeOnline"Features , "WebRenderingEmbed"und "Download" verwenden. Bei der endgültigen Ausführung des Cmdlets wird der gleichen App jedoch die Verwendung der Vorauthentifizierung für alle Features verweigert.

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

Set-SPOTenantPreAuthSettings -IsDisabled $false

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

In diesem Beispiel wird die Vorauthentifizierung insgesamt aktiviert und Anforderungen, die nicht von einer App stammen (z. B. Anforderungen, die über einen Browser gesendet werden), die Vorauthentifizierung für alle Features verweigert.

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.

Die -IncludedFeatures Und -ExcludedFeatures verwenden Featurenamen aus der folgenden Tabelle. Es wird explizit erwähnt, ob das Feature beschädigt wird, wenn es über das PowerShell-Cmdlet deaktiviert wird.