Merge branch 'main' into syntex-settings-support

wlibebe · web-flow · commit d090d5c6774e · 2024-09-03T14:32:54.000-04:00
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Copy-SPOPersonalSitePage.md b/sharepoint/sharepoint-ps/sharepoint-online/Copy-SPOPersonalSitePage.md
@@ -0,0 +1,212 @@
+---
+external help file: sharepointonline.xml
+Module Name: Microsoft.Online.SharePoint.PowerShell
+online version: https://learn.microsoft.com/powershell/module/sharepoint-online/copy-spopersonalsitepage
+applicable: SharePoint Online
+title: Copy-SPOPersonalSitePage
+schema: 2.0.0
+author: xuyangzo
+ms.author: xuyangzou
+ms.reviewer:
+---
+
+# Copy-SPOPersonalSitePage
+
+## SYNOPSIS
+
+This cmdlet command allows you to relocate existing SharePoint pages by utilizing an existing copy operation. We will also copy any assets associated with the SharePoint pages to the new destination. We offer two methods for relocating pages:
+- Copy: This method keeps the original page intact while creating a duplicate at the new location.
+- Move: This method creates a new copy at the new location and deletes the original page from the source.
+
+## SYNTAX
+
+```powershell
+Copy-SPOPersonalSitePage -SourceSite <SpoSitePipeBind> -DestinationSite <SpoSitePipeBind> -PageName <String> -DeleteSourcePage <SwitchParameter> [-Confirm] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+The Copy-SPOPersonalSitePage cmdlet allows a SharePoint Administrator to copy one or more SharePoint pages from a selected source to a chosen destination SharePoint site. If the `-DeleteSourcePage` parameter is set to `$true`, the source page(s) will be deleted after the copy operation, effectively moving the page(s).
+
+> [!NOTE]
+> This cmdlet may not be available in all tenants as the feature rollout could be in progress. If the feature has not been enabled in your tenant, attempting to run this cmdlet will result in an error.
+
+**Where can I move the existing page(s) to and from?**
+
+| Source | Destination |
+| :------------------- | :---------- | 
+| SharePoint pages library in OneDrive for Business  | SharePoint pages library in OneDrive for Business | 
+| SharePoint pages library in OneDrive for Business | SharePoint site | 
+| SharePoint site    | SharePoint site | 
+
+**How do I query the status of my copy operation?**
+
+After this cmdlet is executed, you'll receive the following information:
+
+| Property | Description |
+| :------- | :---------- |
+| ErrorMessage | We will show the corresponding error message, if any error occurs. |
+| JobState | The current state of the job. |
+| NewPageUrl | 	The URL of the new page if the copy operation has completed. |
+| SourcePageName | The name of the source page to be copied. |
+| StatusMessage | A message describing the current status. |
+| WorkItemId | The work item ID used to track the status of the copy job. If the copy operation is complete, this will be `00000000-0000-0000-0000-000000000000`. |
+
+- If the copy is successful, the URL for the new page will be provided.
+- If the copy is still in progress, you will receive the work item ID. You can use the [Get-SPOPersonalSitePageCopyProgress](./Get-SPOPersonalSitePageCopyProgress.md) command to check the status of the URL.
+
+The following table explains the copy job's state:
+
+| Status | Explanation |
+| :---------- | :---------- | 
+| Queued | The copy operation was queued for execution. |
+| CreateAssetsFolderStart | We've started creating a folder to place all associated assets used on this page. |
+| CreateAssetsFolderEnd | We've finished creating a folder to place all associated assets used on this page. |
+| CopyAssetsStart | We've started copying associated assets used on this page. |
+| CopyAssetsEnd | We've finished copying associated assets used on this page. |
+| CreatePageStart | We've started creating a new page. |
+| CreatePageEnd | We've finished creating a new page. |
+| Succeeded | The copy operation was successful. |
+| Deleting | The copy operation was deleted. |
+| Failed | The copy operation failed. |
+| JobNotFound | The copy operation wasn't found. |
+
+## EXAMPLES
+
+### -----------------------EXAMPLE 1-----------------------------
+
+```powershell
+Copy-SPOPersonalSitePage -SourceSite 'https://contoso-my.sharepoint.com/personal/testuser_onmicrosoft_com' -DestinationSite 'https://contoso.sharepoint.com/sites/testsite' -PageName 'TestPage.aspx' -Confirm 
+```
+
+Example 1 demonstrates how a SharePoint Administrator can copy the SharePoint page named `TestPage.aspx` from `testuser`'s SharePoint pages library in OneDrive for Business to the `testsite` SharePoint site with confirmation. The source page will not be deleted.
+
+### -----------------------EXAMPLE 2-----------------------------
+
+```powershell
+Copy-SPOPersonalSitePage -SourceSite 'https://contoso-my.sharepoint.com/personal/testuser_onmicrosoft_com' -DestinationSite 'https://contoso.sharepoint.com/sites/testsite' -PageName 'TestPage.aspx' -DeleteSourcePage
+```
+
+Example 2 demonstrates how a SharePoint Administrator can move the SharePoint page named `TestPage.aspx` from `testuser`'s SharePoint pages library in OneDrive for Business to the `testsite` SharePoint site. The source page will be deleted after the copy operation.
+
+### -----------------------EXAMPLE 3-----------------------------
+
+```powershell
+Copy-SPOPersonalSitePage -SourceSite 'https://contoso.sharepoint.com/sites/sourcesite' -DestinationSite 'https://contoso.sharepoint.com/sites/testsite' -PageName 'TestPage.aspx' -DeleteSourcePage -Confirm
+```
+
+Example 3 demonstrates how a SharePoint Administrator can copy the SharePoint page named `TestPage.aspx` from a SharePoint site name `sourcesite` to the `testsite` SharePoint site with confirmation. The source page will be deleted after the copy operation.
+
+### -----------------------EXAMPLE 4-----------------------------
+
+```powershell
+Copy-SPOPersonalSitePage -SourceSite 'https://contoso-my.sharepoint.com/personal/testuser1_onmicrosoft_com' -DestinationSite 'https://contoso-my.sharepoint.com/personal/testuser2_onmicrosoft_com' -PageName 'TestPage.aspx' -DeleteSourcePage -Confirm
+```
+
+Example 4 demonstrates how a SharePoint Administrator can move the SharePoint page named `TestPage.aspx` from `testuser1`'s SharePoint pages library in OneDrive for Business to `testuser2`'s SharePoint pages library in OneDrive for Business with confirmation. The source page will be deleted after the copy operation.
+
+## PARAMETERS
+
+### -SourceSite
+
+Specifies the URL of the source SharePoint site containing the SharePoint pages to copy.
+
+```yaml
+Type: SpoSitePipeBind
+Parameter Sets: (All)
+Aliases:
+Applicable: SharePoint Online
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -DestinationSite
+
+Specifies the URL of the destination SharePoint site where the SharePoint pages will be copied to.
+
+```yaml
+Type: SpoSitePipeBind
+Parameter Sets: (All)
+Aliases:
+Applicable: SharePoint Online
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -PageName
+
+Specifies the name of the SharePoint page to copy. This parameter is required when not using the `-AllPages` switch.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+Applicable: SharePoint Online
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -DeleteSourcePage
+
+Indicates whether to delete the source SharePoint page(s) after copying. If specified, the operation will move the SharePoint page(s) instead of copying.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+Applicable: SharePoint Online
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Confirm
+
+Prompts for confirmation before executing the command.
+For more information, type the following command: `get-help about_commonparameters`
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: cf
+Applicable: SharePoint Online
+
+Required: False
+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](https://go.microsoft.com/fwlink/?LinkID=113216).
+
+## Notes
+
+**Question: Will SharePoint pages retain their version history after the move?**
+
+Answer: Currently, only the latest published version will be transferred.
+
+**Question: Can recipients of SharePoint pages I shared with continue to access them after the move?**
+
+Answer: All permissions will be removed once the pages are moved.
+
+## RELATED LINKS
+
+[Getting started with SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online)
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-FileSensitivityLabelInfo.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-FileSensitivityLabelInfo.md
@@ -24,7 +24,7 @@ Get-FileSensitivityLabelInfo -FileUrl <String> [<CommonParameters>]
 
 ## DESCRIPTION
 
-The `Get-FileSensitivityLabelInfo` cmdlet runs on a single office online file. If the file has a sensitivity label attached then it returns the id, displayname, isProtectionEnabled flag and id of the parent label (if applicable). You must be a SharePoint Online administrator or Global Administrator to run the `GetFileSensitivityLabelInfo` cmdlet. Note that this cmdlet does not work on files that have labels with custom permission or user defined permission or double key encryption.
+The `Get-FileSensitivityLabelInfo` cmdlet runs on a single office online file. If the file has a sensitivity label attached then it returns the id, displayname, isProtectionEnabled flag and id of the parent label (if applicable). You must be a SharePoint Online administrator to run the `GetFileSensitivityLabelInfo` cmdlet. Note that this cmdlet does not work on files that have labels with custom permission or user defined permission or double key encryption.
 For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell).
 
 ## EXAMPLES
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOAppErrors.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOAppErrors.md
@@ -34,7 +34,7 @@ Date time values that are older than 50 years or later than 20 years from today
 Each error includes the error message, time in UTC that error happened, the site where the error happened, and the error type.
 Values for error type are as follows: 0 - None, 1 - Install Error, 2 - Upgrade Error, 3 - Runtime Error.
 
-You must be a SharePoint Online administrator or Global Administrator to run the cmdlet.
+You must be a SharePoint Online administrator to run the cmdlet.
 
 For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](https://learn.microsoft.com/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps).
 
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOAppInfo.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOAppInfo.md
@@ -30,7 +30,7 @@ Either ProductId or Name must be given. Name is ignored if ProductId is specifie
 
 The returned collection of installed applications contains Product ID (GUID), Product name and Source. Values for source type are as follows: 0 = App Catalog and 1 = Marketplace.
 
-You must be a SharePoint Online administrator or Global Administrator to run the cmdlet.
+You must be a SharePoint Online administrator to run the cmdlet.
 
 For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](https://learn.microsoft.com/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps).
 
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOApplication.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOApplication.md
@@ -2,7 +2,7 @@
 external help file: sharepointonline.xml
 Module Name: Microsoft.Online.SharePoint.PowerShell
 online version: https://learn.microsoft.com/powershell/module/sharepoint-online/get-spoapplication
-applicable: SharePoint Online
+applicable: SharePoint
 title: Get-SPOApplication
 schema: 2.0.0
 author: cindylay
@@ -32,7 +32,7 @@ Get-SPOApplication [[-OwningApplicationId] <OwningApplicationid>] [[-Application
 
 ## DESCRIPTION
 
-The `Get-SPOApplication` cmdlet retrieves and returns all third-party SharePoint Embedded applications registered in a tenant that match the given criteria. You must be a SharePoint Online Administrator or Global Administrator to run the cmdlet. For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps). 
+The `Get-SPOApplication` cmdlet retrieves and returns SharePoint Embedded applications of all publishers registered in a tenant that match the given criteria. You must be a SharePoint Administrator to run the cmdlet. For permissions and the most current information about Windows PowerShell, see the online documentation at [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps). 
 
 ## EXAMPLES
 
@@ -50,37 +50,38 @@ Example 1 returns all SharePoint Embedded applications registered in the specifi
 Get-SPOApplication -OwningApplicationId <OwningApplicationId>
 ```
 
-Example 2 lists the details of the owning application corresponding to the `OwningApplicationId` registered in the specified tenant.
+Example 2 provides details about the owning application in the specified tenant. It returns Applications, which includes the list of guest application IDs with permissions to the owning application, as well as the SharingCapability settings and the OverrideTenantSharingCapability status
 
 ### Example 3
 
 ```powershell
 Get-SPOApplication -OwningApplicationId <OwningApplicationId> -ApplicationId <ApplicationId>
 ```
 
-Example 3 enumerates permissions of the owning applications registered in the specified tenant.
-
+Example 3 enumerates app-only permissions of the guest application specified in `ApplicationId`.
 ## PARAMETERS
 
 ### -OwningApplicationId
 
-Use this parameter to get details about apps registered in the specified tenant.
+Use this parameter to get details about applications registered in the specified tenant.
 
 The following details are returned:
 
 - OwningApplicationId
 
 - OwningApplicationName
 
-- Storage
-
 - Applications (by id)
+
+- SharingCapability
+
+- OverrideTenantSharingCapability
   
 ```yaml
 Type: String
 Parameter Sets: (All)
 Aliases:
-Applicable: SharePoint Online
+Applicable: SharePoint
 
 Required: False
 Position: Named
@@ -91,13 +92,13 @@ Accept wildcard characters: False
 
 ### -ApplicationId
 
-Use this parameter to enumerate permissions of the owning applications registered in the specified tenant.
+Use this parameter to enumerate app-only permissions of the guest application id with access to the specified owning application.
 
 ```yaml
 Type: String
 Parameter Sets: ParamSet2
 Aliases:
-Applicable: SharePoint Online
+Applicable: SharePoint
 
 Required: False
 Position: Named
@@ -114,4 +115,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## RELATED LINKS
 
 [Get-SPOContainer](./Get-SPOContainer.md)
-[Set-SPOApplication] (Set-SPOApplication.md)
+[Set-SPOApplication](./Set-SPOApplication.md)
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOContainer.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOContainer.md
@@ -50,7 +50,7 @@ Get-SPOContainer [[-Identity] <ContainerSiteURL>]
 
 The `Get-SPOContainer` cmdlet retrieves and returns a list of Containers and details of an individual Container created under a SharePoint Embedded application. This command is available only in SharePoint Online Management Shell version 16.0.24211.12000 or higher to run this cmdlet.
 
-You must be a SharePoint Online Administrator or Global Administrator to run this cmdlet.
+You must be a SharePoint Online Administrator to run this cmdlet.
 
 > [!NOTE]  
 > Containers in the Recycle Bin will not be retrieved by using the `Get-SPOContainer` cmdlet. 
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCrossGeoMovedUsers.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCrossGeoMovedUsers.md
@@ -24,7 +24,7 @@ Get-SPOCrossGeoMovedUsers -Direction <String> [<CommonParameters>]
 
 ## DESCRIPTION
 
-This cmdlet allows you to get the moved users out and in the current SPO Site. It requires a connection to a multi-geo tenant to run correctly. You must be a SharePoint Online Administrator or Global Administrator to get the moved users out and in the current SPO site.
+This cmdlet allows you to get the moved users out and in the current SPO Site. It requires a connection to a multi-geo tenant to run correctly. You must be a SharePoint Online Administrator to get the moved users out and in the current SPO site.
 
 ## EXAMPLES
 
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCrossGeoUsers.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCrossGeoUsers.md
@@ -24,7 +24,7 @@ Get-SPOCrossGeoUsers -ValidDataLocation <Boolean> [<CommonParameters>]
 
 ## DESCRIPTION
 
-The Get-SPOCrossGeoUsers cmdlet is used to return the SharePoint Online users that match a given criteria. The ValidDataLocation parameter is a switch used to validate the location of the data. This cmdlet requires a connection to a multi-geo tenant to run correctly. You must have the SharePoint Online Admin role or Global Administrator role to execute this cmdlet.
+The Get-SPOCrossGeoUsers cmdlet is used to return the SharePoint Online users that match a given criteria. The ValidDataLocation parameter is a switch used to validate the location of the data. This cmdlet requires a connection to a multi-geo tenant to run correctly. You must have the SharePoint Online Admin role to execute this cmdlet.
 
 ## EXAMPLES
 
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCrossTenantCompatibilityStatus.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCrossTenantCompatibilityStatus.md
@@ -24,7 +24,7 @@ Get-SPOCrossTenantCompatibilityStatus -PartnerCrossTenantHostUrl <String> [<Comm
 
 ## DESCRIPTION
 
-This cmdlet allows you to determine the compatibility with the partner tenant before cross-tenant migration. You must be a SharePoint Administrator or a Global Administrator to run it.
+This cmdlet allows you to determine the compatibility with the partner tenant before cross-tenant migration. You must be a SharePoint Administrator to run it.
 
 ## EXAMPLES
 
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCrossTenantHostUrl.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCrossTenantHostUrl.md
@@ -24,7 +24,7 @@ Get-SPOCrossTenantHostUrl  [<CommonParameters>]
 
 ## DESCRIPTION
 
-Use this cmdlet to retrieve the cross-tenant host URL. You must be a SharePoint Administrator or a Global Administrator to run the cmdlet.
+Use this cmdlet to retrieve the cross-tenant host URL. You must be a SharePoint Administrator to run the cmdlet.
 
 ## EXAMPLES
 
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODeletedContainer.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODeletedContainer.md
@@ -28,7 +28,7 @@ Get-SPODeletedContainer [<CommonParameters>]
 
 The `Get-SPODeletedContainer` cmdlet returns a list of all deleted File Storage Containers in the Recycle Bin. There is no `Identity` parameter needed. The list includes the `ContainerId`, `ContainerName`, and `CreatedDate`. Deleted Containers in the Recycle Bin are permanently deleted after 93 days. More details in [`Remove-SPOContainer`](./Remove-SPOContainer.md). You can restore a deleted Container with the cmdlet [`Restore-SPODeletedContainer`](./Restore-SPODeletedContainer.md).
 
-You must be a SharePoint Administrator or Global Administrator to run this cmdlet.
+You must be a SharePoint Administrator to run this cmdlet.
 
 For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps).
 
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODeletedSite.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODeletedSite.md
@@ -44,7 +44,7 @@ This action does not restore these returned sites or site collection.
 It only returns their properties so that you can see what sites or site collections have been deleted.
 To restore the site or site collections, forward the results to the `Restore-SPODeletedSite` cmdlet in the pipeline.
 
-You must be a SharePoint Online administrator or Global Administrator and be a site collection administrator for the deleted site collections to run the cmdlet.
+You must be a SharePoint Online administrator and be a site collection administrator for the deleted site collections to run the cmdlet.
 
 For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](https://learn.microsoft.com/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps).
 
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOGeoAdministrator.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOGeoAdministrator.md
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOPersonalSitePageCopyProgress.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOPersonalSitePageCopyProgress.md
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOApplicationPermission.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOApplicationPermission.md
