@pnp/cli-microsoft365 6.8.0-beta.f473be5 → 6.9.0-beta.1cd2525

package/docs/docs/cmd/spo/sitedesign/sitedesign-task-get.md

@@ -1,28 +0,0 @@
-# spo sitedesign task get
-
-Gets information about the specified site design scheduled for execution
-
-## Usage
-
-```sh
-m365 spo sitedesign task get [options]
-```
-
-## Options
-
-`-i, --id <id>`
-: The ID of the site design task to get information for
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Get information about the specified site design scheduled for execution
-
-```sh
-m365 spo sitedesign task get --id 6ec3ca5b-d04b-4381-b169-61378556d76e
-```
-
-## More information
-
-- SharePoint site design and site script overview: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview)

package/docs/docs/cmd/spo/sitedesign/sitedesign-task-list.md

@@ -1,28 +0,0 @@
-# spo sitedesign task list
-
-Lists site designs scheduled for execution on the specified site
-
-## Usage
-
-```sh
-m365 spo sitedesign task list [options]
-```
-
-## Options
-
-`-u, --webUrl <webUrl>`
-: The URL of the site for which to list site designs scheduled for execution
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-List site designs scheduled for execution on the specified site
-
-```sh
-m365 spo sitedesign task list --webUrl https://contoso.sharepoint.com/sites/team-a
-```
-
-## More information
-
-- SharePoint site design and site script overview: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview)

package/docs/docs/cmd/spo/sitedesign/sitedesign-task-remove.md

@@ -1,37 +0,0 @@
-# spo sitedesign task remove
-
-Removes the specified site design scheduled for execution
-
-## Usage
-
-```sh
-m365 spo sitedesign task remove [options]
-```
-
-## Options
-
-`-i, --id <id>`
-: The ID of the site design task to remove
-
-`--confirm`
-: Don't prompt for confirming removing the site design task
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Removes the specified site design task with id _6ec3ca5b-d04b-4381-b169-61378556d76e_ scheduled for execution without prompting confirmation
-
-```sh
-m365 spo sitedesign task remove --id 6ec3ca5b-d04b-4381-b169-61378556d76e --confirm
-```
-
-Removes the specified site design task with id _6ec3ca5b-d04b-4381-b169-61378556d76e_ scheduled for execution with prompt for confirmation before removing
-
-```sh
-m365 spo sitedesign task remove --id 6ec3ca5b-d04b-4381-b169-61378556d76e
-```
-
-## More information
-
-- SharePoint site design and site script overview: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview)

package/docs/docs/cmd/spo/sitescript/sitescript-add.md

@@ -1,38 +0,0 @@
-# spo sitescript add
-
-Adds site script for use with site designs
-
-## Usage
-
-```sh
-m365 spo sitescript add [options]
-```
-
-## Options
-
-`-t, --title <title>`
-: Site script title
-
-`-c, --content <content>`
-: JSON string containing the site script
-
-`-d, --description [description]`
-: Site script description
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-Each time you execute the `spo sitescript add` command, it will create a new site script with a unique ID. Before creating a site script, be sure that another script with the same name doesn't already exist.
-
-## Examples
-
-Create new site script for use with site designs. Script contents are stored in the `$script` variable
-
-```sh
-m365 spo sitescript add --title "Contoso" --description "Contoso theme script" --content $script
-```
-
-## More information
-
-- SharePoint site design and site script overview: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview)

package/docs/docs/cmd/spo/sitescript/sitescript-get.md

@@ -1,32 +0,0 @@
-# spo sitescript get
-
-Gets information about the specified site script
-
-## Usage
-
-```sh
-m365 spo sitescript get [options]
-```
-
-## Options
-
-`-i, --id <id>`
-: Site script ID
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-If the specified `id` doesn't refer to an existing site script, you will get a `File not found` error.
-
-## Examples
-
-Get information about the site script with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a_
-
-```sh
-m365 spo sitescript get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a
-```
-
-## More information
-
-- SharePoint site design and site script overview: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview)

package/docs/docs/cmd/spo/sitescript/sitescript-list.md

@@ -1,25 +0,0 @@
-# spo sitescript list
-
-Lists site script available for use with site designs
-
-## Usage
-
-```sh
-m365 spo sitescript list [options]
-```
-
-## Options
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-List all site scripts available for use with site designs
-
-```sh
-m365 spo sitescript list
-```
-
-## More information
-
-- SharePoint site design and site script overview: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview)

package/docs/docs/cmd/spo/sitescript/sitescript-remove.md

@@ -1,41 +0,0 @@
-# spo sitescript remove
-
-Removes the specified site script
-
-## Usage
-
-```sh
-m365 spo sitescript remove [options]
-```
-
-## Options
-
-`-i, --id <id>`
-: Site script ID
-
-`--confirm`
-: Don't prompt for confirming removing the site script
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-If the specified `id` doesn't refer to an existing site script, you will get a `File not found` error.
-
-## Examples
-
-Remove site script with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a_. Will prompt for confirmation before removing the script
-
-```sh
-m365 spo sitescript remove --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a
-```
-
-Remove site script with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a_ without prompting for confirmation
-
-```sh
-m365 spo sitescript remove --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --confirm
-```
-
-## More information
-
-- SharePoint site design and site script overview: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview)

package/docs/docs/cmd/spo/sitescript/sitescript-set.md

@@ -1,44 +0,0 @@
-# spo sitescript set
-
-Updates existing site script
-
-## Usage
-
-```sh
-m365 spo sitescript set [options]
-```
-
-## Options
-
-`-i, --id <id>`
-: Site script ID
-
-`-t, --title [title]`
-: Site script title
-
-`-d, --description [description]`
-: Site script description
-
-`-v, --version [version]`
-: Site script version
-
-`-c, --content [content]`
-: JSON string containing the site script
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-If the specified `id` doesn't refer to an existing site script, you will get a `File not found` error.
-
-## Examples
-
-Update title of the existing site script with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a_
-
-```sh
-m365 spo sitescript set --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --title "Contoso"
-```
-
-## More information
-
-- SharePoint site design and site script overview: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview)

package/docs/docs/cmd/spo/spo-get.md

@@ -1,60 +0,0 @@
-# spo get
-
-Gets the context URL for the root SharePoint site collection and SharePoint tenant admin site
-
-## Usage
-
-```sh
-m365 spo get [options]
-```
-
-## Options
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-CLI for Microsoft 365 automatically discovers the URL of the root SharePoint site collection/SharePoint tenant admin site (whichever is needed to run the particular command). Using this command you can see which URLs the CLI has discovered.
-
-## Examples
-
-Get the context URL for the root SharePoint site collection and SharePoint tenant admin site
-
-```sh
-m365 spo get --output json
-```
-
-## Response
-
-=== "JSON"
-
-    ```json
-    {
-      "SpoUrl": "https://contoso.sharepoint.com"
-    }
-    ```
-
-=== "Text"
-
-    ```text
-    SpoUrl: https://contoso.sharepoint.com
-    ```
-
-=== "CSV"
-
-    ```csv
-    SpoUrl
-    https://contoso.sharepoint.com
-    ```
-
-=== "Markdown"
-
-    ```md
-    # spo get 
-
-    Date: 4/10/2023
-
-    Property | Value
-    ---------|-------
-    SpoUrl | https://contoso.sharepoint.com
-    ```

package/docs/docs/cmd/spo/spo-search.md

@@ -1,153 +0,0 @@
-# spo search
-
-Executes a search query
-
-## Usage
-
-```sh
-m365 spo search [options]
-```
-
-## Options
-
-`-q, --queryText <queryText>`
-: Query to be executed in KQL format
-
-`-p, --selectProperties [selectProperties]`
-: Comma-separated list of properties to retrieve. Will retrieve all properties if not specified and json output is requested.
-
-`-u, --webUrl [webUrl]`
-: The web against which we want to execute the query. If the parameter is not defined, the query is executed against the web that's used when logging in to the SPO environment.
-
-`--allResults`
-: Set, to get all results of the search query, instead of the number specified by the `rowlimit` (default: 10)
-
-`--rowLimit [rowLimit]`
-: The number of rows to be returned. When the `allResults` option is used, the specified value will define the size of retrieved batches
-
-`--sourceId [sourceId]`
-: The identifier (GUID) of the result source to be used to run the query.
-
-`--trimDuplicates`
-: Set, to remove near duplicate items from the search results.
-
-`--enableStemming`
-: Set, to enable stemming.
-
-`--culture [culture]`
-: The locale for the query.
-
-`--refinementFilters [refinementFilters]`
-: The set of refinement filters used when issuing a refinement query.
-
-`--queryTemplate [queryTemplate]`
-: A string that contains the text that replaces the query text, as part of a query transformation.
-
-`--sortList [sortList]`
-: The list of properties by which the search results are ordered.
-
-`--rankingModelId [rankingModelId]`
-: The ID of the ranking model to use for the query.
-
-`--startRow [startRow]`
-: The first row that is included in the search results that are returned. You use this parameter when you want to implement paging for search results.
-
-`--properties [properties]`
-: Additional properties for the query.
-
-`--sourceName [sourceName]`
-: Specified the name of the result source to be used to run the query.
-
-`--refiners [refiners]`
-: The set of refiners to return in a search result.
-
-`--hiddenConstraints [hiddenConstraints]`
-: The additional query terms to append to the query.
-
-`--clientType [clientType]`
-: The type of the client that issued the query.
-
-`--enablePhonetic`
-: Set, to use the phonetic forms of the query terms to find matches. (Default = `false`).
-
-`--processBestBets`
-: Set, to return best bet results for the query.
-
-`--enableQueryRules`
-: Set, to enable query rules for the query.
-
-`--processPersonalFavorites`
-: Set, to return personal favorites with the search results.
-
-`--rawOutput`
-: Set, to return the unparsed, raw results of the REST call to the search API.
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Execute search query to retrieve all Document Sets (ContentTypeId = _0x0120D520_) for the English locale
-
-```sh
-m365 spo search --queryText "ContentTypeId:0x0120D520" --culture 1033
-```
-
-Retrieve all documents. For each document, retrieve the _Path_, _Author_ and _FileType_.
-
-```sh
-m365 spo search --queryText "IsDocument:1" --selectProperties "Path,Author,FileType" --allResults
-```
-
-Return the top 50 items of which the title starts with _Marketing_ while trimming duplicates.
-
-```sh
-m365 spo search --queryText "Title:Marketing*" --rowLimit=50 --trimDuplicates
-```
-
-Return only items from a specific result source (using the source id).
-
-```sh
-m365 spo search --queryText "*" --sourceId "6e71030e-5e16-4406-9bff-9c1829843083"
-```
-
-## Response
-
-=== "JSON"
-
-    ```json
-    [
-      {
-        "Title": "Document",
-        "OriginalPath": "https://contoso.sharepoint.com/Shared Documents/Document.docx"
-      }
-    ]
-    ```
-
-=== "Text"
-
-    ```text
-    Title     OriginalPath
-    --------  -------------------------------------------------------------
-    Document  https://contoso.sharepoint.com/Shared Documents/Document.docx
-    ```
-
-=== "CSV"
-
-    ```csv
-    Title,OriginalPath
-    Document,https://contoso.sharepoint.com/Shared Documents/Document.docx
-    ```
-
-=== "Markdown"
-
-    ```md
-    # spo search --queryText "Title:Marketing*" --rowLimit "50" --trimDuplicates "true"
-
-    Date: 4/10/2023
-
-    ## Marketing lunch
-    Property | Value
-    ---------|-------
-    Title | Marketing lunch
-    OriginalPath | https://contoso.sharepoint.com/sites/contosoportal/SitePages/Marketing-Lunch.aspx
-    ```

package/docs/docs/cmd/spo/spo-set.md

@@ -1,32 +0,0 @@
-# spo set
-
-Sets the URL of the root SharePoint site collection for use in SPO commands
-
-## Usage
-
-```sh
-m365 spo set [options]
-```
-
-## Options
-
-`-u, --url <url>`
-: The URL of the root SharePoint site collection to use in SPO commands
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-CLI for Microsoft 365 automatically discovers the URL of the root SharePoint site collection/SharePoint tenant admin site (whichever is needed to run the particular command). In specific cases, like when managing multi-geo Microsoft 365 tenants, it could be desirable to make the CLI manage the specific geography. For such cases, you can use this command to explicitly specify the SPO URL that should be used when executing SPO commands.
-
-## Examples
-
-Set SPO URL to the specified URL
-
-```sh
-m365 spo set --url https://contoso.sharepoint.com
-```
-
-## Response
-
-The command won't return a response on success.

package/docs/docs/cmd/spo/storageentity/storageentity-get.md

@@ -1,32 +0,0 @@
-# spo storageentity get
-
-Get details for the specified tenant property
-
-## Usage
-
-```sh
-m365 spo storageentity get [options]
-```
-
-## Options
-
-`-k, --key <key>`
-: Name of the tenant property to retrieve
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-Tenant properties are stored in the app catalog site associated with the site to which you are currently connected. When retrieving the specified tenant property, SharePoint will automatically find the associated app catalog and try to retrieve the property from it.
-
-## Examples
-
-Show the value, description and comment of the _AnalyticsId_ tenant property
-
-```sh
-m365 spo storageentity get -k AnalyticsId
-```
-
-## More information
-
-- SharePoint Framework Tenant Properties: [https://docs.microsoft.com/en-us/sharepoint/dev/spfx/tenant-properties](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/tenant-properties)

package/docs/docs/cmd/spo/storageentity/storageentity-list.md

@@ -1,32 +0,0 @@
-# spo storageentity list
-
-Lists tenant properties stored on the specified SharePoint Online app catalog
-
-## Usage
-
-```sh
-m365 spo storageentity list [options]
-```
-
-## Options
-
-`-u, --appCatalogUrl <appCatalogUrl>`
-: URL of the app catalog site
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-Tenant properties are stored in the app catalog site. To list all tenant properties, you have to specify the absolute URL of the app catalog site. If you specify an incorrect URL, or the site at the given URL is not an app catalog site, no properties will be retrieved.
-
-## Examples
-
-List all tenant properties stored in the _https://contoso.sharepoint.com/sites/appcatalog_ app catalog site
-
-```sh
-m365 spo storageentity list -u https://contoso.sharepoint.com/sites/appcatalog
-```
-
-## More information
-
-- SharePoint Framework Tenant Properties: [https://docs.microsoft.com/en-us/sharepoint/dev/spfx/tenant-properties](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/tenant-properties)

package/docs/docs/cmd/spo/storageentity/storageentity-remove.md

@@ -1,47 +0,0 @@
-# spo storageentity remove
-
-Removes tenant property stored on the specified SharePoint Online app catalog
-
-## Usage
-
-```sh
-m365 spo storageentity remove [options]
-```
-
-## Options
-
-`-u, --appCatalogUrl <appCatalogUrl>`
-: URL of the app catalog site
-
-`-k, --key <key>`
-: Name of the tenant property to retrieve
-
-`--confirm`
-: Don't prompt for confirming removal of a tenant property
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-Tenant properties are stored in the app catalog site associated with that tenant. To remove a property, you have to specify the absolute URL of the app catalog site. If you specify the URL of a site different than the app catalog, you will get an access denied error.
-
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-    
-## Examples
-
-Remove the _AnalyticsId_ tenant property. Yields a confirmation prompt before actually removing the property
-
-```sh
-m365 spo storageentity remove -k AnalyticsId -u https://contoso.sharepoint.com/sites/appcatalog
-```
-
-Remove the _AnalyticsId_ tenant property. Suppresses the confirmation prompt
-
-```sh
-m365 spo storageentity remove -k AnalyticsId --confirm -u https://contoso.sharepoint.com/sites/appcatalog
-```
-
-## More information
-
-- SharePoint Framework Tenant Properties: [https://docs.microsoft.com/en-us/sharepoint/dev/spfx/tenant-properties](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/tenant-properties)

package/docs/docs/cmd/spo/storageentity/storageentity-set.md

@@ -1,49 +0,0 @@
-# spo storageentity set
-
-Sets tenant property on the specified SharePoint Online app catalog
-
-## Usage
-
-```sh
-m365 spo storageentity set [options]
-```
-
-## Options
-
-`-u, --appCatalogUrl <appCatalogUrl>`
-: URL of the app catalog site
-
-`-k, --key <key>`
-: Name of the tenant property to retrieve
-
-`-v, --value <value>`
-: Value to set for the property
-
-`-d, --description [description]`
-: Description to set for the property (optional)
-
-`-c, --comment [comment]`
-: Comment to set for the property (optional)
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-Tenant properties are stored in the app catalog site associated with that tenant. To set a property, you have to specify the absolute URL of the app catalog site without a trailing slash. If you specify the URL with trailing slash you get the error `The managed path sites/apps is not a managed path in this tenant.`
-
-If you specify the URL of a site different than the app catalog, you will get an access denied error.
-
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
-## Examples
-
-Set _123_ as the value of the _AnalyticsId_ tenant property. Also include a description and a comment for additional clarification of the usage of the property.
-
-```sh
-m365 spo storageentity set -k AnalyticsId -v 123 -d 'Web analytics ID' -c 'Use on all sites' -u https://contoso.sharepoint.com/sites/appcatalog
-```
-
-## More information
-
-- SharePoint Framework Tenant Properties: [https://docs.microsoft.com/en-us/sharepoint/dev/spfx/tenant-properties](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/tenant-properties)