@pnp/cli-microsoft365 7.2.0-beta.54705a9 → 7.2.0-beta.6775e3a

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

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

@@ -0,0 +1,98 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant people profilecardproperty list
+
+Lists all profile card properties
+
+## Usage
+
+```sh
+m365 tenant people profilecardproperty list [options]
+```
+
+## Options
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Tenant Administrator** or **Global Administrator**.
+
+:::
+
+## Examples
+
+Lists all profile card properties
+
+```sh
+m365 tenant people profilecardproperty list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "directoryPropertyName": "customAttribute1",
+      "annotations": [
+        {
+          "displayName": "Cost center",
+          "localizations": [
+            {
+              "languageTag": "de",
+              "displayName": "Kostenstelle"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  directoryPropertyName  displayName     displayName de
+  ---------------------  --------------  --------------
+  customAttribute1       Cost center     Kostenstelle
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  directoryPropertyName,displayName,displayName de
+  customAttribute1,Cost center,Kostenstelle
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # tenant people profilecardproperty list
+
+  Date: 11/4/2023
+
+  ## Cost center
+
+  Property | Value
+  ---------|-------
+  directoryPropertyName | customAttribute1
+  displayName | Cost center
+  displayName de | Kostenstelle
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- https://learn.microsoft.com/graph/add-properties-profilecard

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

@@ -0,0 +1,61 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant people profilecardproperty remove
+
+Removes an additional attribute from the profile card properties
+
+## Usage
+
+```sh
+m365 tenant people profilecardproperty remove [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the property to remove. Allowed values: `UserPrincipalName`, `Fax`, `StreetAddress`, `PostalCode`, `StateOrProvince`, `Alias`, `customAttribute1`, `customAttribute2`, `customAttribute3`, `customAttribute4`, `customAttribute5`, `customAttribute6`, `customAttribute7`, `customAttribute8`, `customAttribute9`, `customAttribute10`, `customAttribute11`, `customAttribute12`, `customAttribute13`, `customAttribute14`, `customAttribute15`.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Tenant Administrator** or **Global Administrator**.
+
+:::
+
+:::caution
+
+When removing an attribute from a profile card, it takes up to 24 hours for the change to be displayed.
+
+:::
+
+## Examples
+
+Removes the UPN as a profile property from the profile cards
+
+```sh
+m365 tenant people profilecardproperty remove --name UserPrincipalName
+```
+
+Removes the UPN as a profile property from the profile cards, without showing a confirmation prompt
+
+```sh
+m365 tenant people profilecardproperty remove --name UserPrincipalName --force
+```
+
+## Response
+
+The command won't return a response on success.
+
+## More information
+
+- https://learn.microsoft.com/graph/add-properties-profilecard

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

@@ -0,0 +1,120 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant people profilecardproperty set
+
+Updates a custom attribute to the profile card property
+
+## Usage
+
+```sh
+m365 tenant people profilecardproperty set [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the property to update. Allowed values: `customAttribute1`, `customAttribute2`, `customAttribute3`, `customAttribute4`, `customAttribute5`, `customAttribute6`, `customAttribute7`, `customAttribute8`, `customAttribute9`, `customAttribute10`, `customAttribute11`, `customAttribute12`, `customAttribute13`, `customAttribute14`, `customAttribute15`.
+
+`-d, --displayName <displayName>`
+: The display name of the property.
+```
+
+<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 updating an attribute to a profile card, it takes up to 24 hours for the addition to be displayed.
+
+:::
+
+## Examples
+
+Updates a custom extension attribute to Cost Center
+
+```sh
+m365 tenant people profilecardproperty set --name customAttribute1 --displayName "Cost Center"
+```
+
+Updates a custom extension attribute with translations
+
+```sh
+m365 tenant people profilecardproperty set --name customAttribute1 --displayName "Cost Center" --displayName-nl-NL "Kostencentrum" --displayName-de "Kostenstelle"
+```
+
+## 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 set --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