Get-SPOTenantPreAuthSettings
Gets the configuration of pre-authentication.
Syntax
Default
Get-SPOTenantPreAuthSettings
[<CommonParameters>]
UseGraphUrlSettings
Get-SPOTenantPreAuthSettings
[-UseGraphUrlSettings]
[<CommonParameters>]
Description
Gets the configuration of pre-authentication.
Note
What is pre-authentication?
SharePoint includes self-issued tokens in URLs called pre-authentication URLs (also known as tempauth URLs) to provide temporary access to a SharePoint resource, which helps support more rich user experiences. For example, a common scenario is downloading a file using a URL that includes a token in the tempauth query parameter like the following:
https://<tenant>.sharepoint.com/sites/samplesite/_layouts/15/download.aspx?UniqueId=<id>&tempauth=v1.ey...
But this feature is currently being deprecated. You can use the related Set-SPOTenantPreAuthSettings to control the use of pre-authentication in various use cases.
Microsoft Graph URL settings
Microsoft Graph file APIs can return URLs that applications use to download, upload, preview, transform, or monitor file operations. Some of these URLs have historically included pre-authentication tokens or redirected clients to pre-authenticated URLs.
Use this cmdlet to get details on the use graph url setting configuration.
Examples
Example 1
Get-SPOTenantPreAuthSettings
This example returns all the pre-authentication settings for the tenant as an object.
Example 2
Get-SPOTenantPreAuthSettings | ConvertTo-Json
Gets all the pre-authentication settings for the tenant. Note that this example uses ConvertTo-Json to display the settings in JSON format since more complex Allow or Deny lists may be hard to read as an object.
Parameters
-UseGraphUrlSettings
Returns the configuration that controls whether supported Microsoft Graph file APIs return Microsoft Graph URLs for configured applications.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UseGraphUrlSettings
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.