@pnp/cli-microsoft365 7.1.0 → 7.2.0-beta.0642f3a

package/docs/docs/cmd/aad/administrativeunit/administrativeunit-remove.mdx

@@ -0,0 +1,56 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# aad administrativeunit remove
+
+Removes an administrative unit
+
+## Usage
+
+```sh
+m365 aad administrativeunit remove [options]
+```
+
+## options
+
+```md definition-list
+`-i, --id [id]`
+: The id of the administrative unit. Specify either `id` or `displayName` but not both.
+
+`-n, --displayName [displayName]`
+: The display name of the administrative unit. Specify either `id` or `displayName` but not both.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Global Administrator** or **Privileged Role Administrator**.
+
+:::
+
+## Examples
+
+Remove an administrative unit by its id
+
+```sh
+m365 aad administrativeunit remove --id 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
+```
+
+Remove an administrative unit by it displayName
+
+```sh
+m365 aad administrativeunit remove --displayName 'Marketing Division'
+```
+
+## Response
+
+The command won't return a response on success
+
+## More information
+
+- Administrative units: https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units

package/docs/docs/cmd/{search/externalconnection/externalconnection-add.mdx → external/connection/connection-add.mdx}

@@ -1,26 +1,32 @@
 import Global from '/docs/cmd/_global.mdx';
 
-# search externalconnection add
+# external connection add
 
-Add a new external connection to be defined for Microsoft Search
+Add a new external connection
 
 ## Usage
 
 ```sh
-m365 search externalconnection add [options]
+m365 external connection add [options]
+```
+
+## Alias
+
+```sh
+m365 search externalconnection add
 ```
 
 ## Options
 
 ```md definition-list
 `-i, --id <id>`
-: Developer-provided unique ID of the connection within the Azure Active Directory tenant
+: Developer-provided unique ID of the connection within the Azure Active Directory tenant.
 
 `-n, --name <name>`
-: The display name of the connection to be displayed in the Microsoft 365 admin center. Maximum length of 128 characters
+: The display name of the connection to be displayed in the Microsoft 365 admin center. Maximum length of 128 characters.
 
 `-d, --description <description>`
-: Description of the connection displayed in the Microsoft 365 admin center
+: Description of the connection displayed in the Microsoft 365 admin center.
 
 `--authorizedAppIds [authorizedAppIds]`
 : Comma-separated collection of application IDs for registered Azure Active Directory apps that are allowed to manage the external connection and to index content in the external connection.
@@ -34,16 +40,16 @@ The `id` must be at least 3 and no more than 32 characters long. It can contain
 
 ## Examples
 
-Adds a new external connection with name and description of test app
+Adds a new external connection with name and description of test app.
 
 ```sh
-m365 search externalconnection add --id MyApp --name "Test" --description "Test"
+m365 external connection add --id MyApp --name "Test" --description "Test"
 ```
 
-Adds a new external connection with a limited number of authorized apps
+Adds a new external connection with a limited number of authorized apps.
 
 ```sh
-m365 search externalconnection add --id MyApp --name "Test" --description "Test" --authorizedAppIds  "00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002"
+m365 external connection add --id MyApp --name "Test" --description "Test" --authorizedAppIds  "00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002"
 ```
 
 ## Response

package/docs/docs/cmd/{search/externalconnection/externalconnection-get.mdx → external/connection/connection-get.mdx}

@@ -2,40 +2,46 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# search externalconnection get
+# external connection get
 
-Allow the administrator to get a specific external connection for use in Microsoft Search.
+Allow the administrator to get a specific external connection
 
 ## Usage
 
 ```sh
-m365 search externalconnection get [options]
+m365 external connection get [options]
+```
+
+## Alias
+
+```sh
+m365 search externalconnection get
 ```
 
 ## Options
 
 ```md definition-list
 `-i, --id [id]`
-: ID of the External Connection to get. Specify either `id` or `name`
+: ID of the External Connection to get. Specify either `id` or `name`.
 
 `-n, --name [name]`
-: Name of the External Connection to get. Specify either `id` or `name`
+: Name of the External Connection to get. Specify either `id` or `name`.
 ```
 
 <Global />
 
 ## Examples
 
-Get the External Connection by its id
+Get the External Connection by its id.
 
 ```sh
-m365 search externalconnection get --id "MyApp"
+m365 external connection get --id "MyApp"
 ```
 
-Get the External Connection by its name
+Get the External Connection by its name.
 
 ```sh
-m365 search externalconnection get --name "Test"
+m365 external connection get --name "Test"
 ```
 
 ## Response
@@ -83,7 +89,7 @@ m365 search externalconnection get --name "Test"
   <TabItem value="Markdown">
 
   ```md
-  # search externalconnection get --id "CLITest"
+  # external connection get --id "CLITest"
 
   Date: 2022-11-05
 
@@ -99,4 +105,3 @@ m365 search externalconnection get --name "Test"
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/{search/externalconnection/externalconnection-list.mdx → external/connection/connection-list.mdx}

@@ -2,14 +2,20 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# search externalconnection list
+# external connection list
 
-Lists external connections defined in Microsoft Search
+Lists external connections
 
 ## Usage
 
 ```sh
-m365 search externalconnection list [options]
+m365 external connection list [options]
+```
+
+## Alias
+
+```sh
+m365 search externalconnection list
 ```
 
 ## Options
@@ -18,10 +24,10 @@ m365 search externalconnection list [options]
 
 ## Examples
 
-List external connections defined in Microsoft Search
+List external connections.
 
 ```sh
-m365 search externalconnection list
+m365 external connection list
 ```
 
 ## Response
@@ -69,7 +75,7 @@ m365 search externalconnection list
   <TabItem value="Markdown">
 
   ```md
-  # search externalconnection list
+  # external connection list
 
   Date: 2022-09-05
 
@@ -85,4 +91,3 @@ m365 search externalconnection list
 
   </TabItem>
 </Tabs>
-

package/docs/docs/cmd/external/connection/connection-remove.mdx

@@ -0,0 +1,54 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# external connection remove
+
+Allow the administrator to remove a specific external connection
+
+## Usage
+
+```sh
+m365 external connection remove [options]
+```
+
+## Alias
+
+```sh
+m365 search externalconnection remove
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: ID of the External Connection to remove. Specify either `id` or `name`.
+
+`-n, --name [name]`
+: Name of the External Connection to remove. Specify either `id` or `name`.
+
+`-f, --force`
+: Don't prompt for confirming removing the connection.
+```
+
+<Global />
+
+## Remarks
+
+If the command finds multiple external connections with the specified name, it will prompt you to disambiguate which external connection it should remove, listing the discovered IDs.
+
+## Examples
+
+Removes external connection by its id.
+
+```sh
+m365 external connection remove --id "MyApp"
+```
+
+Removes external connection by its name. Will NOT prompt for confirmation before removing.
+
+```sh
+m365 external connection remove --name "Test" --force
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/external/connection/connection-schema-add.mdx

@@ -0,0 +1,41 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# external connection schema add
+
+Allow the administrator to add a schema to a specific external connection
+
+## Usage
+
+```sh
+m365 external connection schema add [options]
+```
+
+## Alias
+
+```sh
+m365 search externalconnection schema add
+```
+
+## Options
+
+```md definition-list
+`-i, --externalConnectionId  <externalConnectionId>`
+: ID of the External Connection.
+
+`-s, --schema [schema]`
+: The schema object to be added.
+```
+
+<Global />
+
+## Examples
+
+Adds a new schema to a specific external connection.
+
+```sh
+m365 external connection schema add --externalConnectionId 'CliConnectionId' --schema '{"baseType":"microsoft.graph.externalItem","properties":[{"name":"ticketTitle","type":"String","isSearchable":"true","isRetrievable":"true","labels":["title"]},{"name":"priority","type":"String","isQueryable":"true","isRetrievable":"true","isSearchable":"false"},{"name":"assignee","type":"String","isRetrievable":"true"}]}'
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spfx/project/project-upgrade.mdx

@@ -35,7 +35,7 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.18.0).
+The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.18.1-rc.0).
 
 This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
 

package/docs/docs/cmd/spo/file/file-rename.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file rename
 

package/docs/docs/cmd/spo/site/site-set.mdx

@@ -49,6 +49,9 @@ m365 spo site set [options]
 `--siteLogoUrl [siteLogoUrl]`
 : Set the logo for the site collection. This can be an absolute or relative URL to a file on the current site collection.
 
+`--siteThumbnailUrl [siteThumbnailUrl]`
+: Set the thumbnail for the site collection. This can be an absolute or relative URL to a file on the current site collection.
+
 `--resourceQuota [resourceQuota]`
 : The quota for this site collection in Sandboxed Solutions units
 
@@ -184,6 +187,18 @@ Unset the logo on the site
 m365 spo site set --url https://contoso.sharepoint.com/sites/sales --siteLogoUrl ""
 ```
 
+Set the thumbnail on the site
+
+```sh
+m365 spo site set --url https://contoso.sharepoint.com/sites/sales --siteThumbnailUrl "/sites/sales/SiteAssets/parker-ms-1200.png"
+```
+
+Unset the thumbnail on the site
+
+```sh
+m365 spo site set --url https://contoso.sharepoint.com/sites/sales --siteThumbnailUrl ""
+```
+
 Lock the site preventing users from accessing it. Wait for the configuration to complete
 
 ```sh

package/docs/docs/cmd/tenant/people/people-profilecardproperty-add.mdx

@@ -0,0 +1,126 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant people profilecardproperty add
+
+Adds an additional attribute to the profile card properties
+
+## Usage
+
+```sh
+m365 tenant people profilecardproperty add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the property to add. Allowed values: `UserPrincipalName`, `Fax`, `StreetAddress`, `PostalCode`, `StateOrProvince`, `Alias`, `customAttribute1`, `customAttribute2`, `customAttribute3`, `customAttribute4`, `customAttribute5`, `customAttribute6`, `customAttribute7`, `customAttribute8`, `customAttribute9`, `customAttribute10`, `customAttribute11`, `customAttribute12`, `customAttribute13`, `customAttribute14`, `customAttribute15`.
+
+`-d, --displayName [displayName]`
+: The display name of a property, only use this together with a custom extension attribute.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Tenant Administrator** or **Global Administrator**.
+
+:::
+
+:::info
+
+You can specify localized values for the `displayName` as well. These can be entered by suffixing the displayName option with a language code: `--displayName-nl-NL "Kostencentrum"`, `--displayName-de "Kostenstelle"`.
+
+:::
+
+:::caution
+
+When adding an attribute to a profile card, it takes up to 24 hours for the addition to be displayed.
+
+:::
+
+## Examples
+
+Add the UPN as a profile property to the profile cards properties
+
+```sh
+m365 tenant people profilecardproperty add --name UserPrincipalName
+```
+
+Add a custom extension attribute _Cost Center_ as a profile property to the profile cards properties
+
+```sh
+m365 tenant people profilecardproperty add --name customAttribute1 --displayName 'Cost Center'
+```
+
+Add a custom extension attribute _Cost Center_ as a profile property to the profile cards properties with a Dutch localization
+
+```sh
+m365 tenant people profilecardproperty add --name customAttribute1 --displayName 'Cost Center' --displayName-nl-NL 'Kostencentrum'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "directoryPropertyName": "customAttribute1",
+    "annotations": [
+      {
+        "displayName": "Cost center",
+        "localizations": [
+          {
+            "languageTag": "nl-NL",
+            "displayName": "Kostenplaats"
+          }
+        ]
+      }
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  directoryPropertyName: customAttribute1
+  displayName          : Cost center
+  displayName nl-NL    : Kostenplaats
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  directoryPropertyName,displayName,displayName nl-NL
+  customAttribute1,Cost center,Kostenplaats
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # tenant people profilecardproperty add --name 'customAttribute1' --displayName 'Cost center' --displayName-nl-NL 'Kostenplaats'
+
+  Date: 11/2/2023
+
+  Property | Value
+  ---------|-------
+  directoryPropertyName | customAttribute1
+  displayName           | Cost center
+  displayName nl-NL     | Kostenplaats
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- https://learn.microsoft.com/graph/add-properties-profilecard

package/docs/docs/cmd/tenant/people/people-profilecardproperty-get.mdx

@@ -0,0 +1,101 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant people profilecardproperty get
+
+Retrieves information about a specific profile card property
+
+## Usage
+
+```sh
+m365 tenant people profilecardproperty get [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the property to retrieve. Allowed values: `UserPrincipalName`, `Fax`, `StreetAddress`, `PostalCode`, `StateOrProvince`, `Alias`, `customAttribute1`, `customAttribute2`, `customAttribute3`, `customAttribute4`, `customAttribute5`, `customAttribute6`, `customAttribute7`, `customAttribute8`, `customAttribute9`, `customAttribute10`, `customAttribute11`, `customAttribute12`, `customAttribute13`, `customAttribute14`, `customAttribute15`.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Tenant Administrator** or **Global Administrator**.
+
+:::
+
+## Examples
+
+Retrieve information about a specific profile card property
+
+```sh
+m365 tenant people profilecardproperty get --name customAttribute1
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "directoryPropertyName": "customAttribute1",
+    "annotations": [
+      {
+        "displayName": "Cost center",
+        "localizations": [
+          {
+            "languageTag": "nl-NL",
+            "displayName": "Kostencentrum"
+          }
+        ]
+      }
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  directoryPropertyName: customAttribute1
+  displayName          : Cost center
+  displayName nl-NL    : Kostencentrum
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  directoryPropertyName,displayName,displayName nl-NL
+  customAttribute1,Cost center,Kostencentrum
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # tenant people profilecardproperty get --name "customAttribute1"
+
+  Date: 3/11/2023
+
+  ## Cost center
+
+  Property | Value
+  ---------|-------
+  directoryPropertyName | customAttribute1
+  displayName | Cost center
+  displayName nl-NL | Kostencentrum
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- https://learn.microsoft.com/graph/add-properties-profilecard