Merge branch 'dev' into fix/AzureAutomationException

documentation/Add-PnPApp.md

@@ -21,6 +21,8 @@ Add-PnPApp [-Path] <String> [-Scope <AppCatalogScope>] [-Overwrite] [-Timeout <I
 
 ## DESCRIPTION
 
+Allows to upload an app to the app catalog at tenant or site collection level. By specifying `-Publish` option it is possible to deploy/trust it at the same time.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPAvailableSiteClassification.md

@@ -25,6 +25,8 @@ Add-PnPAvailableSiteClassification -Classifications <System.Collections.Generic.
 
 ## DESCRIPTION
 
+Allows to add classic site classification values
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPAzureADGroupMember.md

@@ -25,6 +25,8 @@ Add-PnPAzureADGroupMember -Identity <AzureADGroupPipeBind> -Users <String[]> [-R
 
 ## DESCRIPTION
 
+Allows to add users to Azure Active Directory Group. This can be a security, distribution or Microsoft 365 group. By specifying `-RemoveExisting` option it is possible to first clear the group of all existing members.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPAzureADGroupOwner.md

@@ -25,6 +25,8 @@ Add-PnPAzureADGroupOwner -Identity <AzureADGroupPipeBind> -Users <String[]> [-Re
 
 ## DESCRIPTION
 
+Allows to add users to owners of an Azure Active Directory Group. This can be a security, distribution or Microsoft 365 group. By specifying `-RemoveExisting` option it is possible to first clear the group of all existing members.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPContentTypeToDocumentSet.md

@@ -21,6 +21,8 @@ Add-PnPContentTypeToDocumentSet -ContentType <ContentTypePipeBind[]> -DocumentSe
 
 ## DESCRIPTION
 
+Allows to add content type to document set.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPContentTypeToList.md

@@ -21,6 +21,8 @@ Add-PnPContentTypeToList -List <ListPipeBind> -ContentType <ContentTypePipeBind>
 
 ## DESCRIPTION
 
+Allows to add content type to list. By specifying `-DefaultContentType` option it is possible set the newly added content type as default.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPContentTypesFromContentTypeHub.md

@@ -25,6 +25,8 @@ Add-PnPContentTypesFromContentTypeHub -ContentTypes List<String> [-Site <SitePip
 
 ## DESCRIPTION
 
+Allows to add content types from content type hub site to current site. In case the same content type is already present on the current site then the latest published version will be used.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPDataRowsToSiteTemplate.md

@@ -21,6 +21,7 @@ Add-PnPDataRowsToSiteTemplate [-Path] <String> -List <ListPipeBind> [-Query <Str
 ```
 
 ## DESCRIPTION
+Allows to add datarows to list inside a PnP Provisioning Template. The command allows to specify the fields which should be retrieved using `-Fields` option and filter the datarows to be used by using `-Query` option.
 
 ## EXAMPLES
 

documentation/Add-PnPDocumentSet.md

@@ -20,6 +20,7 @@ Add-PnPDocumentSet -List <ListPipeBind> -Name <String> -ContentType <ContentType
 ```
 
 ## DESCRIPTION
+Allows to add new document set to library.
 
 ## EXAMPLES
 

documentation/Add-PnPFieldFromXml.md

@@ -21,6 +21,8 @@ Add-PnPFieldFromXml [-List <ListPipeBind>] [-FieldXml] <String>
 
 ## DESCRIPTION
 
+Allows to add new field by specifying its definition in CAML/XML format to list or site columns.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPFieldToContentType.md

@@ -21,6 +21,8 @@ Add-PnPFieldToContentType -Field <FieldPipeBind> -ContentType <ContentTypePipeBi
 
 ## DESCRIPTION
 
+Allows to add a field from site columns to an existing content type.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPFileToSiteTemplate.md

@@ -12,10 +12,6 @@ title: Add-PnPFileToSiteTemplate
 ## SYNOPSIS
 Adds a file to a PnP Provisioning Template package
 
-## Description
-
-Allows adding a file to a PnP Provisioning Template package (.pnp) so that the file will get uploaded to the SharePoint Online site to which the template is being invoked. This allows the file to be referenced in i.e. a document template, site logo or any other component that references a file.
-
 ## SYNTAX
 
 ### Local File
@@ -35,6 +31,8 @@ Add-PnPFileToSiteTemplate [-Path] <String> [-SourceUrl] <String> [[-Container] <
 
 ## DESCRIPTION
 
+Allows adding a file to a PnP Provisioning Template package (.pnp) so that the file will get uploaded to the SharePoint Online site to which the template is being invoked. This allows the file to be referenced in i.e. a document template, site logo or any other component that references a file.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPFolder.md

@@ -21,6 +21,8 @@ Add-PnPFolder -Name <String> -Folder <FolderPipeBind> [-Connection <PnPConnectio
 
 ## DESCRIPTION
 
+Allows to add a new folder.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPGroupMember.md

@@ -28,6 +28,8 @@ Add-PnPGroupMember -Group <GroupPipeBind> -EmailAddress <String> [-SendEmail] [-
 
 ## DESCRIPTION
 
+Allows to add new user to SharePoint group. The SharePoint group may be specified either by id, name or related object.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPHtmlPublishingPageLayout.md

@@ -22,6 +22,8 @@ Add-PnPHtmlPublishingPageLayout -SourceFilePath <String> -Title <String> -Descri
 
 ## DESCRIPTION
 
+Allows to add a HTML based publishing page layout.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPIndexedProperty.md

@@ -21,6 +21,8 @@ Add-PnPIndexedProperty [-Key] <String> [-List <ListPipeBind>]
 
 ## DESCRIPTION
 
+Allows to set search index on propertybag key.
+
 ## EXAMPLES
 
 ## PARAMETERS

documentation/Add-PnPListDesign.md

@@ -27,6 +27,8 @@ Add-PnPListDesign -Title <String> -SiteScriptIds <Guid[]> [-Description <String>
 
 ## DESCRIPTION
 
+Allows to add new List Design to tenant.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPListFoldersToSiteTemplate.md

@@ -22,6 +22,8 @@ Add-PnPListFoldersToSiteTemplate [-Path] <String> [-List] <ListPipeBind> [-Recur
 
 ## DESCRIPTION
 
+Allows to add folders to a list in a PnP Provisioning Template.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPListItem.md

@@ -35,6 +35,8 @@ Add-PnPListItem [-List] <ListPipeBind> -Batch <PnPBatch> [-ContentType <ContentT
 
 ## DESCRIPTION
 
+Allows to add an item to the list and sets the creation time to the current date and time. The author is set to the current authenticated user executing the cmdlet. In order to set the author to a different user, please refer to Set-PnPListItem.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPListItemComment.md

@@ -21,6 +21,8 @@ Add-PnPListItemComment [-List] <ListPipeBind> [-Identity] <ListItemPipeBind> [-T
 
 ## DESCRIPTION
 
+Allows to add comment to the specified list item.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPMasterPage.md

@@ -22,6 +22,8 @@ Add-PnPMasterPage -SourceFilePath <String> -Title <String> -Description <String>
 
 ## DESCRIPTION
 
+Allows to add Masterpage.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPMicrosoft365GroupMember.md

@@ -25,6 +25,8 @@ Add-PnPMicrosoft365GroupMember -Identity <Microsoft365GroupPipeBind> -Users <Str
 
 ## DESCRIPTION
 
+Allows to add multiple users to Microsoft 365 Group.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPMicrosoft365GroupOwner.md

@@ -25,6 +25,8 @@ Add-PnPMicrosoft365GroupOwner -Identity <Microsoft365GroupPipeBind> -Users <Stri
 
 ## DESCRIPTION
 
+Allows to add multiple users to Microsoft 365 Group as owners.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPOrgNewsSite.md

@@ -25,6 +25,8 @@ Add-PnPOrgNewsSite -OrgNewsSiteUrl <SitePipeBind> [-Connection <PnPConnection>]
 
 ## DESCRIPTION
 
+Allows to add site as an organization news source in your tenant.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPPageSection.md

@@ -22,6 +22,8 @@ Add-PnPPageSection [-Page] <PagePipeBind> -SectionTemplate <CanvasSectionTemplat
 
 ## DESCRIPTION
 
+Allows to add a new section to a page.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPPublishingImageRendition.md

@@ -21,6 +21,8 @@ Add-PnPPublishingImageRendition -Name <String> -Width <Int32> -Height <Int32>
 
 ## DESCRIPTION
 
+Allowss to add an Image Rendition.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPPublishingPage.md

@@ -21,6 +21,8 @@ Add-PnPPublishingPage -PageName <String> [-FolderPath <String>] -PageTemplateNam
 
 ## DESCRIPTION
 
+Allows to add a publishing page.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPPublishingPageLayout.md

@@ -22,6 +22,8 @@ Add-PnPPublishingPageLayout -SourceFilePath <String> -Title <String> -Descriptio
 
 ## DESCRIPTION
 
+Allows to add a publishing page layout and associate it to a content type.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPSiteCollectionAppCatalog.md

@@ -25,6 +25,8 @@ Add-PnPSiteCollectionAppCatalog [-Site <SitePipeBind>] [-Connection <PnPConnecti
 
 ## DESCRIPTION
 
+Allows to add Site Collection scoped App Catalog.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPSiteDesign.md

@@ -28,6 +28,8 @@ Add-PnPSiteDesign -Title <String> -SiteScriptIds <Guid[]> [-Description <String>
 
 ## DESCRIPTION
 
+Allows to add a new Site Design on the current tenant.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPSiteDesignTask.md

@@ -21,6 +21,8 @@ Add-PnPSiteDesignTask -SiteDesignId <Guid> [-WebUrl <String>] [-Connection <PnPC
 
 ## DESCRIPTION
 
+Allows to apply a site design to a specified site collection. This command is intended to be used when you need to apply a large number of actions or multiple site scripts.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPSiteScript.md

@@ -25,6 +25,8 @@ Add-PnPSiteScript -Title <String> [-Description <String>] -Content <String> [-Co
 
 ## DESCRIPTION
 
+Allows to add a Site Script on the current tenant.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPSiteScriptPackage.md

@@ -25,6 +25,8 @@ Add-PnPSiteScriptPackage -Title <String> [-Description <String>] -ContentPath <S
 
 ## DESCRIPTION
 
+Allows to add a new Site Script Package on the current tenant
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPSiteTemplate.md

@@ -20,6 +20,8 @@ Add-PnPSiteTemplate -SiteTemplate <SiteTemplate> -TenantTemplate <ProvisioningHi
 
 ## DESCRIPTION
 
+Allows to add PnP Site Template object to a tenant template.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPTeamsChannel.md

@@ -36,6 +36,8 @@ Add-PnPTeamsChannel -Team <TeamsTeamPipeBind> -DisplayName <String> -ChannelType
 
 ## DESCRIPTION
 
+Allows to add channel to an existing team in Microsoft Teams. By using the `IsFavoriteByDefault` it is possible to specify if the channel will be visible for members by default.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPTeamsTab.md

@@ -26,6 +26,8 @@ Add-PnPTeamsTab -Team <TeamsTeamPipeBind> -Channel <TeamsChannelPipeBind> -Displ
 
 ## DESCRIPTION
 
+Allows to add a tab to an existing Channel. By using `ContentUrl` option you may specify the content of the tab.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPTenantSequence.md

@@ -21,6 +21,8 @@ Add-PnPTenantSequence -Template <ProvisioningHierarchy> -Sequence <ProvisioningS
 
 ## DESCRIPTION
 
+Allows to add a a tenant sequence object to a tenant template.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPTenantSequenceSite.md

@@ -21,6 +21,8 @@ Add-PnPTenantSequenceSite -Site <ProvisioningSitePipeBind> -Sequence <Provisioni
 
 ## DESCRIPTION
 
+Allows to add a existing tenant sequence site object to a tenant template.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPTenantSequenceSubSite.md

@@ -21,6 +21,8 @@ Add-PnPTenantSequenceSubSite -SubSite <TeamNoGroupSubSite> -Site <SiteCollection
 
 ## DESCRIPTION
 
+Allows to add a tenant sequence sub site object to a tenant sequence site object.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPView.md

@@ -22,6 +22,8 @@ Add-PnPView [-List] <ListPipeBind> -Title <String> [-Query <String>] -Fields <St
 
 ## DESCRIPTION
 
+Allows to add a new view to a list.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPVivaConnectionsDashboardACE.md

@@ -20,6 +20,8 @@ Add-PnPVivaConnectionsDashboardACE [-Identity <DefaultACE>] [-Title <string>] [-
 
 ## DESCRIPTION
 
+Allows to add a new an Adaptive card extension in the Viva Home dashboard page. Before running the command it is required you are connect to a SharePoint Home site and have configured the Viva connections page. 
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPWebPartToWebPartPage.md

@@ -28,6 +28,8 @@ Add-PnPWebPartToWebPartPage -ServerRelativePageUrl <String> -Path <String> -Zone
 
 ## DESCRIPTION
 
+Allows to add a web part to a web part page. Use the `ZoneIndex` option to specifi the zone.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Add-PnPWebPartToWikiPage.md

@@ -28,6 +28,8 @@ Add-PnPWebPartToWikiPage -ServerRelativePageUrl <String> -Path <String> -Row <In
 
 ## DESCRIPTION
 
+Allows to add a web part a wiki page. Use the `Row` and `Column` option to specify the location of the web part.
+
 ## EXAMPLES
 
 ### EXAMPLE 1