Merge pull request #812 from lw-msft/patch-2

Add Documentation for SPOTenantPreAuthSettings

Author: Ruchika-mittal01

sharepoint/sharepoint-ps/sharepoint-online/Clear-SPOTenantPreAuthSettings.md

@@ -0,0 +1,81 @@
+---
+external help file: sharepointonline.xml
+Module Name: Microsoft.Online.SharePoint.PowerShell
+online version: https://learn.microsoft.com/powershell/module/sharepoint-online/clear-spotenantpreauthsettings
+applicable: SharePoint Online
+title: Clear-SPOTenantPreAuthSettings
+schema: 2.0.0
+author: lw-msft
+ms.author: laurenwong
+ms.reviewer:
+manager: bhaveshd
+---
+
+# Clear-SPOTenantPreAuthSettings
+
+## SYNOPSIS
+
+Clears the pre-authentication settings for either the allow or deny list. 
+
+## SYNTAX
+
+```powershell
+Clear-SPOTenantPreAuthSettings -Type <TenantPreAuthSettingsListType> [-WhatIf] [-Confirm] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Clears the pre-authentication settings for either the allow or deny list.
+
+> [!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...`
+>
+> This feature is currently being deprecated and you can use the related [Set-SPOTenantPreAuthSettings](Set-SPOTenantPreAuthSettings.md) to control the use of pre-authentication in various use cases.
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+Clear-SPOTenantPreAuthSettings –Type Allow
+```
+
+This example clears all list items from the allow list.
+
+### EXAMPLE 2
+
+```powershell
+Clear-SPOTenantPreAuthSettings –Type Deny 
+```
+
+This example clears all list items from the deny list. 
+
+## PARAMETERS
+
+### -Type
+
+This parameter indicates whether the cmdlet is interacting with the allow list or the deny list.
+
+PARAMVALUE: Allow | Deny
+
+```yaml
+Type: TenantPreAuthSettingsListType
+Applicable: SharePoint Online
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-5.1).
+
+## RELATED LINKS
+
+- [Get-SPOTenantPreAuthSettings](Get-SPOTenantPreAuthSettings.md)
+- [Set-SPOTenantPreAuthSettings](Set-SPOTenantPreAuthSettings.md)

sharepoint/sharepoint-ps/sharepoint-online/Get-SPOTenantPreAuthSettings.md

@@ -0,0 +1,65 @@
+---
+external help file: sharepointonline.xml
+Module Name: Microsoft.Online.SharePoint.PowerShell
+online version: https://learn.microsoft.com/powershell/module/sharepoint-online/get-spotenantpreauthsettings
+applicable: SharePoint Online
+title: Get-SPOTenantPreAuthSettings
+schema: 2.0.0
+author: lw-msft
+ms.author: laurenwong
+ms.reviewer:
+manager: bhaveshd
+---
+
+# Get-SPOTenantPreAuthSettings
+
+## SYNOPSIS
+
+Gets the configuration of pre-authentication.
+
+## SYNTAX
+
+```powershell
+Get-SPOTenantPreAuthSettings [<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](Set-SPOTenantPreAuthSettings.md) to control the use of pre-authentication in various use cases.
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+Get-SPOTenantPreAuthSettings
+```
+
+This example returns all the pre-authentication settings for the tenant as an object.
+
+### EXAMPLE 2
+
+```powershell
+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
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-5.1).
+
+## RELATED LINKS
+
+- [Set-SPOTenantPreAuthSettings](Set-SPOTenantPreAuthSettings.md)
+- [Clear-SPOTenantPreAuthSettings](Clear-SPOTenantPreAuthSettings.md)