@pnp/cli-microsoft365 6.8.0-beta.9f8a015 → 6.8.0-beta.c5c3c32

package/dist/m365/spo/commands/term/term-group-list.js

@@ -8,10 +8,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _SpoTermGroupListCommand_instances, _SpoTermGroupListCommand_initTelemetry, _SpoTermGroupListCommand_initOptions, _SpoTermGroupListCommand_initValidators;
 Object.defineProperty(exports, "__esModule", { value: true });
 const config_1 = require("../../../../config");
 const request_1 = require("../../../../request");
 const spo_1 = require("../../../../utils/spo");
+const validation_1 = require("../../../../utils/validation");
 const SpoCommand_1 = require("../../../base/SpoCommand");
 const commands_1 = require("../../commands");
 class SpoTermGroupListCommand extends SpoCommand_1.default {
@@ -24,16 +31,23 @@ class SpoTermGroupListCommand extends SpoCommand_1.default {
     defaultProperties() {
         return ['Id', 'Name'];
     }
-    commandAction(logger) {
+    constructor() {
+        super();
+        _SpoTermGroupListCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoTermGroupListCommand_instances, "m", _SpoTermGroupListCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpoTermGroupListCommand_instances, "m", _SpoTermGroupListCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoTermGroupListCommand_instances, "m", _SpoTermGroupListCommand_initValidators).call(this);
+    }
+    commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const spoAdminUrl = yield spo_1.spo.getSpoAdminUrl(logger, this.debug);
-                const res = yield spo_1.spo.getRequestDigest(spoAdminUrl);
+                const spoWebUrl = args.options.webUrl ? args.options.webUrl : yield spo_1.spo.getSpoAdminUrl(logger, this.debug);
+                const res = yield spo_1.spo.getRequestDigest(spoWebUrl);
                 if (this.verbose) {
                     logger.logToStderr(`Retrieving taxonomy term groups...`);
                 }
                 const requestOptions = {
-                    url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
+                    url: `${spoWebUrl}/_vti_bin/client.svc/ProcessQuery`,
                     headers: {
                         'X-RequestDigest': res.FormDigestValue
                     },
@@ -61,5 +75,26 @@ class SpoTermGroupListCommand extends SpoCommand_1.default {
         });
     }
 }
+_SpoTermGroupListCommand_instances = new WeakSet(), _SpoTermGroupListCommand_initTelemetry = function _SpoTermGroupListCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            webUrl: typeof args.options.webUrl !== 'undefined'
+        });
+    });
+}, _SpoTermGroupListCommand_initOptions = function _SpoTermGroupListCommand_initOptions() {
+    this.options.unshift({
+        option: '-u, --webUrl [webUrl]'
+    });
+}, _SpoTermGroupListCommand_initValidators = function _SpoTermGroupListCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (args.options.webUrl) {
+            const isValidSharePointUrl = validation_1.validation.isValidSharePointUrl(args.options.webUrl);
+            if (isValidSharePointUrl !== true) {
+                return isValidSharePointUrl;
+            }
+        }
+        return true;
+    }));
+};
 module.exports = new SpoTermGroupListCommand();
 //# sourceMappingURL=term-group-list.js.map

package/dist/m365/spo/commands/term/term-list.js

@@ -44,22 +44,22 @@ class SpoTermListCommand extends SpoCommand_1.default {
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const spoAdminUrl = yield spo_1.spo.getSpoAdminUrl(logger, this.debug);
-                const res = yield spo_1.spo.getRequestDigest(spoAdminUrl);
+                const spoWebUrl = args.options.webUrl ? args.options.webUrl : yield spo_1.spo.getSpoAdminUrl(logger, this.debug);
+                const res = yield spo_1.spo.getRequestDigest(spoWebUrl);
                 if (this.verbose) {
                     logger.logToStderr(`Retrieving taxonomy term sets...`);
                 }
                 const termGroupQuery = args.options.termGroupId ? `<Method Id="77" ParentId="75" Name="GetById"><Parameters><Parameter Type="Guid">{${args.options.termGroupId}}</Parameter></Parameters></Method>` : `<Method Id="77" ParentId="75" Name="GetByName"><Parameters><Parameter Type="String">${formatting_1.formatting.escapeXml(args.options.termGroupName)}</Parameter></Parameters></Method>`;
                 const termSetQuery = args.options.termSetId ? `<Method Id="82" ParentId="80" Name="GetById"><Parameters><Parameter Type="Guid">{${args.options.termSetId}}</Parameter></Parameters></Method>` : `<Method Id="82" ParentId="80" Name="GetByName"><Parameters><Parameter Type="String">${formatting_1.formatting.escapeXml(args.options.termSetName)}</Parameter></Parameters></Method>`;
                 const data = `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config_1.default.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="70" ObjectPathId="69" /><ObjectIdentityQuery Id="71" ObjectPathId="69" /><ObjectPath Id="73" ObjectPathId="72" /><ObjectIdentityQuery Id="74" ObjectPathId="72" /><ObjectPath Id="76" ObjectPathId="75" /><ObjectPath Id="78" ObjectPathId="77" /><ObjectIdentityQuery Id="79" ObjectPathId="77" /><ObjectPath Id="81" ObjectPathId="80" /><ObjectPath Id="83" ObjectPathId="82" /><ObjectIdentityQuery Id="84" ObjectPathId="82" /><ObjectPath Id="86" ObjectPathId="85" /><Query Id="87" ObjectPathId="85"><Query SelectAllProperties="false"><Properties /></Query><ChildItemQuery SelectAllProperties="true"><Properties><Property Name="Name" ScalarProperty="true" /><Property Name="Id" ScalarProperty="true" /></Properties></ChildItemQuery></Query></Actions><ObjectPaths><StaticMethod Id="69" Name="GetTaxonomySession" TypeId="{981cbc68-9edc-4f8d-872f-71146fcbb84f}" /><Method Id="72" ParentId="69" Name="GetDefaultSiteCollectionTermStore" /><Property Id="75" ParentId="72" Name="Groups" />${termGroupQuery}<Property Id="80" ParentId="77" Name="TermSets" />${termSetQuery}<Property Id="85" ParentId="82" Name="Terms" /></ObjectPaths></Request>`;
-                const result = yield this.executeCsomCall(data, spoAdminUrl, res);
+                const result = yield this.executeCsomCall(data, spoWebUrl, res);
                 const terms = [];
                 if (result._Child_Items_ && result._Child_Items_.length > 0) {
                     for (const term of result._Child_Items_) {
                         this.setTermDetails(term);
                         terms.push(term);
                         if (args.options.includeChildTerms && term.TermsCount > 0) {
-                            yield this.getChildTerms(spoAdminUrl, res, term);
+                            yield this.getChildTerms(spoWebUrl, res, term);
                         }
                     }
                 }
@@ -108,17 +108,17 @@ class SpoTermListCommand extends SpoCommand_1.default {
             }
         });
     }
-    getChildTerms(spoAdminUrl, res, parentTerm) {
+    getChildTerms(spoWebUrl, res, parentTerm) {
         return __awaiter(this, void 0, void 0, function* () {
             parentTerm.Children = [];
             const data = `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config_1.default.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="20" ObjectPathId="19" /><Query Id="21" ObjectPathId="19"><Query SelectAllProperties="false"><Properties /></Query><ChildItemQuery SelectAllProperties="true"><Properties><Property Name="CustomSortOrder" ScalarProperty="true" /><Property Name="CustomProperties" ScalarProperty="true" /><Property Name="LocalCustomProperties" ScalarProperty="true" /></Properties></ChildItemQuery></Query></Actions><ObjectPaths><Property Id="19" ParentId="16" Name="Terms" /><Identity Id="16" Name="${parentTerm._ObjectIdentity_}" /></ObjectPaths></Request>`;
-            const result = yield this.executeCsomCall(data, spoAdminUrl, res);
+            const result = yield this.executeCsomCall(data, spoWebUrl, res);
             if (result._Child_Items_ && result._Child_Items_.length > 0) {
                 for (const term of result._Child_Items_) {
                     this.setTermDetails(term);
                     parentTerm.Children.push(term);
                     if (term.TermsCount > 0) {
-                        yield this.getChildTerms(spoAdminUrl, res, term);
+                        yield this.getChildTerms(spoWebUrl, res, term);
                     }
                 }
             }
@@ -132,10 +132,10 @@ class SpoTermListCommand extends SpoCommand_1.default {
     parseTermDateToIsoString(dateAsString) {
         return new Date(Number(dateAsString.replace('/Date(', '').replace(')/', ''))).toISOString();
     }
-    executeCsomCall(data, spoAdminUrl, res) {
+    executeCsomCall(data, spoWebUrl, res) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = {
-                url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
+                url: `${spoWebUrl}/_vti_bin/client.svc/ProcessQuery`,
                 headers: {
                     'X-RequestDigest': res.FormDigestValue
                 },
@@ -154,6 +154,7 @@ class SpoTermListCommand extends SpoCommand_1.default {
 _SpoTermListCommand_instances = new WeakSet(), _SpoTermListCommand_initTelemetry = function _SpoTermListCommand_initTelemetry() {
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
+            webUrl: typeof args.options.webUrl !== 'undefined',
             termGroupId: typeof args.options.termGroupId !== 'undefined',
             termGroupName: typeof args.options.termGroupName !== 'undefined',
             termSetId: typeof args.options.termSetId !== 'undefined',
@@ -163,6 +164,8 @@ _SpoTermListCommand_instances = new WeakSet(), _SpoTermListCommand_initTelemetry
     });
 }, _SpoTermListCommand_initOptions = function _SpoTermListCommand_initOptions() {
     this.options.unshift({
+        option: '-u, --webUrl [webUrl]'
+    }, {
         option: '--termGroupId [termGroupId]'
     }, {
         option: '--termGroupName [termGroupName]'
@@ -175,6 +178,12 @@ _SpoTermListCommand_instances = new WeakSet(), _SpoTermListCommand_initTelemetry
     });
 }, _SpoTermListCommand_initValidators = function _SpoTermListCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (args.options.webUrl) {
+            const isValidSharePointUrl = validation_1.validation.isValidSharePointUrl(args.options.webUrl);
+            if (isValidSharePointUrl !== true) {
+                return isValidSharePointUrl;
+            }
+        }
         if (args.options.termGroupId && !validation_1.validation.isValidGuid(args.options.termGroupId)) {
             return `${args.options.termGroupId} is not a valid GUID`;
         }

package/dist/m365/spo/commands/term/term-set-get.js

@@ -40,15 +40,15 @@ class SpoTermSetGetCommand extends SpoCommand_1.default {
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const spoAdminUrl = yield spo_1.spo.getSpoAdminUrl(logger, this.debug);
-                const res = yield spo_1.spo.getRequestDigest(spoAdminUrl);
+                const spoWebUrl = args.options.webUrl ? args.options.webUrl : yield spo_1.spo.getSpoAdminUrl(logger, this.debug);
+                const res = yield spo_1.spo.getRequestDigest(spoWebUrl);
                 if (this.verbose) {
                     logger.logToStderr(`Retrieving taxonomy term set...`);
                 }
                 const termGroupQuery = args.options.termGroupId ? `<Method Id="62" ParentId="60" Name="GetById"><Parameters><Parameter Type="Guid">{${args.options.termGroupId}}</Parameter></Parameters></Method>` : `<Method Id="62" ParentId="60" Name="GetByName"><Parameters><Parameter Type="String">${formatting_1.formatting.escapeXml(args.options.termGroupName)}</Parameter></Parameters></Method>`;
                 const termSetQuery = args.options.id ? `<Method Id="67" ParentId="65" Name="GetById"><Parameters><Parameter Type="Guid">{${args.options.id}}</Parameter></Parameters></Method>` : `<Method Id="67" ParentId="65" Name="GetByName"><Parameters><Parameter Type="String">${formatting_1.formatting.escapeXml(args.options.name)}</Parameter></Parameters></Method>`;
                 const requestOptions = {
-                    url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
+                    url: `${spoWebUrl}/_vti_bin/client.svc/ProcessQuery`,
                     headers: {
                         'X-RequestDigest': res.FormDigestValue
                     },
@@ -77,6 +77,7 @@ class SpoTermSetGetCommand extends SpoCommand_1.default {
 _SpoTermSetGetCommand_instances = new WeakSet(), _SpoTermSetGetCommand_initTelemetry = function _SpoTermSetGetCommand_initTelemetry() {
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
+            webUrl: typeof args.options.webUrl !== 'undefined',
             id: typeof args.options.id !== 'undefined',
             name: typeof args.options.name !== 'undefined',
             termGroupId: typeof args.options.termGroupId !== 'undefined',
@@ -85,6 +86,8 @@ _SpoTermSetGetCommand_instances = new WeakSet(), _SpoTermSetGetCommand_initTelem
     });
 }, _SpoTermSetGetCommand_initOptions = function _SpoTermSetGetCommand_initOptions() {
     this.options.unshift({
+        option: '-u, --webUrl [webUrl]'
+    }, {
         option: '-i, --id [id]'
     }, {
         option: '-n, --name [name]'
@@ -95,6 +98,12 @@ _SpoTermSetGetCommand_instances = new WeakSet(), _SpoTermSetGetCommand_initTelem
     });
 }, _SpoTermSetGetCommand_initValidators = function _SpoTermSetGetCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (args.options.webUrl) {
+            const isValidSharePointUrl = validation_1.validation.isValidSharePointUrl(args.options.webUrl);
+            if (isValidSharePointUrl !== true) {
+                return isValidSharePointUrl;
+            }
+        }
         if (args.options.id) {
             if (!validation_1.validation.isValidGuid(args.options.id)) {
                 return `${args.options.id} is not a valid GUID`;

package/dist/m365/spo/commands.js

@@ -202,6 +202,7 @@ exports.default = {
     PAGE_SECTION_GET: `${prefix} page section get`,
     PAGE_SECTION_LIST: `${prefix} page section list`,
     PAGE_TEMPLATE_LIST: `${prefix} page template list`,
+    PAGE_TEMPLATE_REMOVE: `${prefix} page template remove`,
     PAGE_TEXT_ADD: `${prefix} page text add`,
     PROPERTYBAG_GET: `${prefix} propertybag get`,
     PROPERTYBAG_LIST: `${prefix} propertybag list`,

package/docs/docs/cmd/aad/o365group/o365group-get.md

@@ -8,12 +8,6 @@ Gets information about the specified Microsoft 365 Group or Microsoft Teams team
 m365 aad o365group get [options]
 ```
 
-## Alias
-
-```sh
-m365 teams team get
-```
-
 ## Options
 
 `-i, --id <id>`
@@ -37,9 +31,3 @@ Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-9
 ```sh
 m365 aad o365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSiteUrl
 ```
-
-Get information about the Microsoft Teams team with id _2eaf7dcd-7e83-4c3a-94f7-932a1299c844_
-
-```sh
-m365 teams team get --id 2eaf7dcd-7e83-4c3a-94f7-932a1299c844
-```

package/docs/docs/cmd/docs.md

@@ -0,0 +1,51 @@
+# docs
+
+Returns the CLI for Microsoft 365 docs webpage URL
+
+## Usage
+
+```sh
+m365 docs [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+Configure `autoOpenLinksInBrowser` using [cli config set](../cmd/cli/config/config-set.md) to automatically open the webpage in the default browser.
+
+## Examples
+
+Returns the CLI for Microsoft 365 docs webpage URL
+
+```sh
+m365 docs
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    "https://pnp.github.io/cli-microsoft365/"
+    ```
+
+=== "Text"
+
+    ```text
+    https://pnp.github.io/cli-microsoft365/
+    ```
+
+=== "CSV"
+
+    ```csv
+    https://pnp.github.io/cli-microsoft365/
+    ```
+
+=== "Markdown"
+
+    ```md
+    https://pnp.github.io/cli-microsoft365/
+    ```

package/docs/docs/cmd/pa/app/app-consent-set.md

@@ -0,0 +1,47 @@
+# pa app consent set
+
+Configures if users can bypass the API Consent window for the selected canvas app
+
+## Usage
+
+```sh
+m365 pa app consent set [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment.
+
+`-n, --name <name>`
+: The name of the Power App to update
+
+`-b, --bypass <bypass>`
+: Set to `true` to allow users to bypass the API Consent window. Set to `false` to disable the bypass.
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+This command only works for canvas apps.
+
+## Examples
+
+Enables the bypass for the specified canvas app
+
+```sh
+m365 pa app consent set --environment 4be50206-9576-4237-8b17-38d8aadfaa36 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --bypass true
+```
+
+Disables the bypass consent for the specified canvas app
+
+```sh
+m365 pa app consent set --environment 4be50206-9576-4237-8b17-38d8aadfaa36 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --bypass false --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/planner/task/task-get.md

@@ -8,12 +8,6 @@ Retrieve the specified planner task
 m365 planner task get [options]
 ```
 
-## Alias
-
-```sh
-m365 planner task details get [options]
-```
-
 ## Options
 
 `-i, --id  [id]`

package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-get.md

@@ -0,0 +1,118 @@
+# purview sensitivitylabel get
+
+Retrieve the specified sensitivity label
+
+## Usage
+
+```sh
+m365 purview sensitivitylabel get [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The Id of the sensitivity label.
+
+`--userId [userId]`
+: User's Azure AD ID. Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: User's UPN (user principal name, e.g. johndoe@example.com). Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+!!! attention
+    When operating in app-only mode, you have the option to use either the `userName` or `userId` parameters to retrieve the sensitivity policy settings for a specific user. Without specifying either of these parameters, the command will retrieve the sensitivity policy settings for the currently authenticated user when operating in delegated mode.
+
+
+## Examples
+
+Get a sensitivity label
+
+```sh
+m365 purview sensitivitylabel get --id 6f4fb2db-ecf4-4279-94ba-23d059bf157e
+```
+
+Get a sensitivity label that a specific user has access to by its Id
+
+```sh
+m365 purview sensitivitylabel get --id 6f4fb2db-ecf4-4279-94ba-23d059bf157e --userId 59f80e08-24b1-41f8-8586-16765fd830d3
+```
+
+Get a sensitivity label that a specific user has access to by its UPN
+
+```sh
+m365 purview sensitivitylabel get --id 6f4fb2db-ecf4-4279-94ba-23d059bf157e --userName john.doe@contoso.com
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "6f4fb2db-ecf4-4279-94ba-23d059bf157e",
+      "name": "Unrestricted",
+      "description": "",
+      "color": "",
+      "sensitivity": 0,
+      "tooltip": "Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.",
+      "isActive": true,
+      "isAppliable": true,
+      "contentFormats": [
+        "file",
+        "email"
+      ],
+      "hasProtection": false
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    color         :
+    contentFormats: ["file","email"]
+    description   :
+    hasProtection : false
+    id            : 6f4fb2db-ecf4-4279-94ba-23d059bf157e
+    isActive      : true
+    isAppliable   : true
+    name          : Unrestricted
+    sensitivity   : 0
+    tooltip       : Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,name,description,color,sensitivity,tooltip,isActive,isAppliable,contentFormats,hasProtection
+    6f4fb2db-ecf4-4279-94ba-23d059bf157e,Unrestricted,,,0,"Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.",1,1,"[""file"",""email""]",
+    ```
+
+=== "Markdown"
+
+    ```md
+    # purview sensitivitylabel get --id "6f4fb2db-ecf4-4279-94ba-23d059bf157e"
+
+    Date: 3/25/2023
+
+    ## Unrestricted (6f4fb2db-ecf4-4279-94ba-23d059bf157e)
+
+    Property | Value
+    ---------|-------
+    id | 6f4fb2db-ecf4-4279-94ba-23d059bf157e
+    name | Unrestricted
+    description |
+    color |
+    sensitivity | 0
+    tooltip | Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.
+    isActive | true
+    isAppliable | true
+    contentFormats | ["file","email"]
+    hasProtection | false
+    ```

package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-list.md

@@ -0,0 +1,111 @@
+# purview sensitivitylabel list
+
+Get a list of sensitivity labels
+
+## Usage
+
+```sh
+m365 purview sensitivitylabel list [options]
+```
+
+## Options
+
+`--userId [userId]`
+: User's Azure AD ID. Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: User's UPN (user principal name, e.g. johndoe@example.com). Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+!!! attention
+    When operating in app-only mode, you have the option to use either the `userName` or `userId` parameters to retrieve the sensitivity label for a specific user. Without specifying either of these parameters, the command will retrieve the sensitivity label for the currently authenticated user when operating in delegated mode.
+
+## Examples
+
+Get a list of sensitivity labels
+
+```sh
+m365 purview sensitivitylabel list
+```
+
+Get a list of sensitivity labels that a specific user has access to by its Id
+
+```sh
+m365 purview sensitivitylabel list --userId 59f80e08-24b1-41f8-8586-16765fd830d3
+```
+
+Get a list of sensitivity labels that a specific user has access to by its UPN
+
+```sh
+m365 purview sensitivitylabel list --userName john.doe@contoso.com
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id": "6f4fb2db-ecf4-4279-94ba-23d059bf157e",
+        "name": "Unrestricted",
+        "description": "",
+        "color": "",
+        "sensitivity": 0,
+        "tooltip": "Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.",
+        "isActive": true,
+        "isAppliable": true,
+        "contentFormats": [
+          "file",
+          "email"
+        ],
+        "hasProtection": false,
+        "parent": null
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                                    name                   isActive
+    ------------------------------------  ---------------------  --------
+    6f4fb2db-ecf4-4279-94ba-23d059bf157e  Unrestricted           true
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,name,isActive
+    6f4fb2db-ecf4-4279-94ba-23d059bf157e,Unrestricted,1
+    ```
+
+=== "Markdown"
+
+    ```md
+    # purview sensitivitylabel list
+
+    Date: 3/26/2023
+
+    ## Unrestricted (6f4fb2db-ecf4-4279-94ba-23d059bf157e)
+
+    Property | Value
+    ---------|-------
+    id | 6f4fb2db-ecf4-4279-94ba-23d059bf157e
+    name | Unrestricted
+    description |
+    color |
+    sensitivity | 0
+    tooltip | Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.
+    isActive | true
+    isAppliable | true
+    contentFormats | ["file","email"]
+    hasProtection | false
+    parent | null
+    ```