@pnp/cli-microsoft365 6.3.0-beta.fee5cdb → 6.4.0-beta.b1f742c

package/dist/m365/spo/commands/site/site-add.js

@@ -166,7 +166,6 @@ class SpoSiteAddCommand extends SpoCommand_1.default {
     }
     createClassicSite(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            this.dots = '';
             try {
                 this.spoAdminUrl = yield spo_1.spo.getSpoAdminUrl(logger, this.debug);
                 this.context = yield spo_1.spo.ensureFormDigest(this.spoAdminUrl, logger, this.context, this.debug);
@@ -228,7 +227,6 @@ class SpoSiteAddCommand extends SpoCommand_1.default {
                                 reject,
                                 logger,
                                 currentContext: this.context,
-                                dots: this.dots,
                                 verbose: this.verbose,
                                 debug: this.debug
                             });
@@ -362,7 +360,6 @@ class SpoSiteAddCommand extends SpoCommand_1.default {
                             reject,
                             logger,
                             currentContext: this.context,
-                            dots: this.dots,
                             verbose: this.verbose,
                             debug: this.debug
                         });

package/dist/m365/spo/commands/site/site-remove.js

@@ -43,7 +43,6 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
         return __awaiter(this, void 0, void 0, function* () {
             const removeSite = () => __awaiter(this, void 0, void 0, function* () {
                 try {
-                    this.dots = '';
                     if (args.options.fromRecycleBin) {
                         yield this.deleteSiteWithoutGroup(logger, args);
                     }
@@ -203,7 +202,6 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
                             reject,
                             logger,
                             currentContext: this.context,
-                            dots: this.dots,
                             debug: this.debug,
                             verbose: this.verbose
                         });
@@ -248,7 +246,6 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
                             reject,
                             logger,
                             currentContext: this.context,
-                            dots: this.dots,
                             debug: this.debug,
                             verbose: this.verbose
                         });

package/dist/m365/spo/commands/site/site-set.js

@@ -46,7 +46,6 @@ class SpoSiteSetCommand extends SpoCommand_1.default {
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                this.dots = '';
                 this.tenantId = yield spo_1.spo.getTenantId(logger, this.debug);
                 this.spoAdminUrl = yield spo_1.spo.getSpoAdminUrl(logger, this.debug);
                 this.context = yield spo_1.spo.ensureFormDigest(this.spoAdminUrl, logger, this.context, this.debug);
@@ -128,7 +127,6 @@ class SpoSiteSetCommand extends SpoCommand_1.default {
                         reject,
                         logger,
                         currentContext: this.context,
-                        dots: this.dots,
                         debug: this.debug,
                         verbose: this.verbose
                     });

package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-remove.js

@@ -74,7 +74,6 @@ class SpoTenantRecycleBinItemRemoveCommand extends SpoCommand_1.default {
                                     reject,
                                     logger,
                                     currentContext: this.context,
-                                    dots: this.dots,
                                     debug: this.debug,
                                     verbose: this.verbose
                                 });

package/dist/m365/teams/commands/team/team-add.js

@@ -44,7 +44,6 @@ class TeamsTeamAddCommand extends GraphCommand_1.default {
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            this.dots = '';
             let requestBody;
             if (args.options.template) {
                 if (this.verbose) {
@@ -95,7 +94,7 @@ class TeamsTeamAddCommand extends GraphCommand_1.default {
                     }
                     else {
                         setTimeout(() => {
-                            this.waitUntilFinished(requestOptions, resolve, reject, logger, this.dots);
+                            this.waitUntilFinished(requestOptions, resolve, reject, logger);
                         }, this.pollingInterval);
                     }
                 }));
@@ -113,11 +112,7 @@ class TeamsTeamAddCommand extends GraphCommand_1.default {
             }
         });
     }
-    waitUntilFinished(requestOptions, resolve, reject, logger, dots) {
-        if (!this.debug && this.verbose) {
-            dots += '.';
-            process.stdout.write(`\r${dots}`);
-        }
+    waitUntilFinished(requestOptions, resolve, reject, logger) {
         request_1.default
             .get(requestOptions)
             .then((teamsAsyncOperation) => {
@@ -133,7 +128,7 @@ class TeamsTeamAddCommand extends GraphCommand_1.default {
                 return;
             }
             setTimeout(() => {
-                this.waitUntilFinished(requestOptions, resolve, reject, logger, dots);
+                this.waitUntilFinished(requestOptions, resolve, reject, logger);
             }, this.pollingInterval);
         }).catch(err => reject(err));
     }

package/dist/utils/session.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.session = void 0;
+const crypto = require("crypto");
+const cache_1 = require("./cache");
+exports.session = {
+    getId(pid) {
+        const key = `${pid.toString()}_session`;
+        let sessionId = cache_1.cache.getValue(key);
+        if (sessionId) {
+            return sessionId;
+        }
+        sessionId = crypto.randomBytes(24).toString('base64');
+        cache_1.cache.setValue(key, sessionId);
+        return sessionId;
+    }
+};
+//# sourceMappingURL=session.js.map

package/dist/utils/spo.js

@@ -56,7 +56,7 @@ exports.spo = {
             });
         });
     },
-    waitUntilFinished({ operationId, siteUrl, resolve, reject, logger, currentContext, dots, debug, verbose }) {
+    waitUntilFinished({ operationId, siteUrl, resolve, reject, logger, currentContext, debug, verbose }) {
         exports.spo
             .ensureFormDigest(siteUrl, logger, currentContext, debug)
             .then((res) => {
@@ -64,10 +64,6 @@ exports.spo = {
             if (debug) {
                 logger.logToStderr(`Checking if operation ${operationId} completed...`);
             }
-            if (!debug && verbose) {
-                dots += '.';
-                process.stdout.write(`\r${dots}`);
-            }
             const requestOptions = {
                 url: `${siteUrl}/_vti_bin/client.svc/ProcessQuery`,
                 headers: {
@@ -101,7 +97,6 @@ exports.spo = {
                         reject,
                         logger,
                         currentContext,
-                        dots,
                         debug,
                         verbose
                     });
@@ -109,7 +104,7 @@ exports.spo = {
             }
         });
     },
-    waitUntilCopyJobFinished({ copyJobInfo, siteUrl, pollingInterval, resolve, reject, logger, dots, debug, verbose }) {
+    waitUntilCopyJobFinished({ copyJobInfo, siteUrl, pollingInterval, resolve, reject, logger, debug, verbose }) {
         const requestUrl = `${siteUrl}/_api/site/GetCopyJobProgress`;
         const requestOptions = {
             url: requestUrl,
@@ -119,10 +114,6 @@ exports.spo = {
             data: { "copyJobInfo": copyJobInfo },
             responseType: 'json'
         };
-        if (!debug && verbose) {
-            dots += '.';
-            process.stdout.write(`\r${dots}`);
-        }
         request_1.default
             .post(requestOptions)
             .then((resp) => {
@@ -149,7 +140,7 @@ exports.spo = {
             }
             else {
                 setTimeout(() => {
-                    exports.spo.waitUntilCopyJobFinished({ copyJobInfo, siteUrl, pollingInterval, resolve, reject, logger, dots, debug, verbose });
+                    exports.spo.waitUntilCopyJobFinished({ copyJobInfo, siteUrl, pollingInterval, resolve, reject, logger, debug, verbose });
                 }, pollingInterval);
             }
         });

package/docs/docs/cmd/aad/license/license-list.md

@@ -0,0 +1,87 @@
+# aad license list
+
+Lists commercial subscriptions that an organization has acquired
+
+## Usage
+
+```sh
+m365 aad license list [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List all licenses within the tenant
+
+```sh
+m365 aad license list
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "capabilityStatus": "Enabled",
+        "consumedUnits": 1,
+        "id": "48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df",
+        "skuId": "c7df2760-2c81-4ef7-b578-5b5392b571df",
+        "skuPartNumber": "ENTERPRISEPREMIUM",
+        "appliesTo": "User",
+        "prepaidUnits": {
+          "enabled": 10000,
+          "suspended": 0,
+          "warning": 0
+        },
+        "servicePlans": [
+            {
+                "servicePlanId": "8c098270-9dd4-4350-9b30-ba4703f3b36b",
+                "servicePlanName": "ADALLOM_S_O365",
+                "provisioningStatus": "Success",
+                "appliesTo": "User"
+            }
+        ]
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                                                                         skuId                                 skuPartNumber
+    -------------------------------------------------------------------------  ------------------------------------  ----------------------
+    48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df  c7df2760-2c81-4ef7-b578-5b5392b571df  ENTERPRISEPREMIUM
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,skuId,skuPartNumber
+    48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df,c7df2760-2c81-4ef7-b578-5b5392b571df,ENTERPRISEPREMIUM
+    ```
+    
+=== "Markdown"
+
+    ```md
+    # aad license list
+
+    Date: 14/2/2023
+
+    ## 48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df
+
+    Property | Value
+    ---------|-------
+    capabilityStatus | Enabled
+    consumedUnits | 1
+    id | 48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df
+    skuId | c7df2760-2c81-4ef7-b578-5b5392b571df
+    skuPartNumber | ENTERPRISEPREMIUM
+    appliesTo | User
+    prepaidUnits | {"enabled":10000,"suspended":0,"warning":0}
+    servicePlans | [{"servicePlanId":"8c098270-9dd4-4350-9b30-ba4703f3b36b","servicePlanName": "ADALLOM_S_O365","provisioningStatus": "Success","appliesTo": "User"}]
+    ```

package/docs/docs/cmd/aad/user/user-add.md

@@ -0,0 +1,168 @@
+# aad user add
+
+Creates a new user
+
+## Usage
+
+```sh
+m365 aad user add [options]
+```
+
+## Options
+
+`--displayName <displayName>`
+: The name to display in the address book for the user.
+
+`--userName <userName>`
+: The user principal name (someuser@contoso.com).
+
+`--accountEnabled [accountEnabled]`
+: Whether the account is enabled. Possible values: `true`, `false`. Default value is `true`.
+
+`--mailNickname [mailNickname]`
+: The mail alias for the user. By default this value will be extracted from `userName`.
+
+`--password [password]`
+: The password for the user. When not specified, a password will be generated.
+
+`--firstName [firstName]`
+: The given name (first name) of the user. Maximum length is 64 characters.
+
+`--lastName [lastName]`
+: The user's surname (family name or last name). Maximum length is 64 characters.
+
+`--forceChangePasswordNextSignIn`
+: Whether the user should change his/her password on the next login.
+
+`--forceChangePasswordNextSignInWithMfa`
+: Whether the user should change his/her password on the next login and setup MFA.
+
+`--usageLocation [usageLocation]`
+: A two letter [country code](https://learn.microsoft.com/en-us/partner-center/commercial-marketplace-co-sell-location-codes#country-and-region-codes) (ISO standard 3166). Required for users that will be assigned licenses.
+
+`--officeLocation [officeLocation]` 
+: The office location in the user's place of business.
+
+`--jobTitle [jobTitle]`
+: The user's job title. Maximum length is 128 characters.
+
+`--companyName [companyName]`
+: The company name which the user is associated. The maximum length is 64 characters.
+
+`--department [department]`
+: The name for the department in which the user works. Maximum length is 64 characters.
+
+`--preferredLanguage [preferredLanguage]`
+: The preferred language for the user. Should follow [ISO 639-1 Code](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a). Example: `en-US`.
+
+`--managerUserId [managerUserId]`
+: User ID of the user's manager. Specify `managerUserId` or `managerUserName` but not both.
+
+`--managerUserName [managerUserName]`
+: User principal name of the manager. Specify `managerUserId` or `managerUserName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! important
+    To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator
+
+!!! note
+    After running this command, it may take a minute before the user is effectively created in the tenant.
+
+## Examples
+
+Create a user and let him/her update the password at first login
+
+```sh
+m365 aad user add --displayName "John Doe" --userName "john.doe@contoso.com" --password "SomePassw0rd" --forceChangePasswordNextSignIn
+```
+
+Create a user with job information
+
+```sh
+m365 aad user add --displayName "John Doe" --userName "john.doe@contoso.com" --password "SomePassw0rd" --firstName John --lastName Doe --jobTitle "Sales Manager" --companyName Contoso --department Sales --officeLocation Vosselaar --forceChangePasswordNextSignIn
+```
+
+Create a user with language information
+
+```sh
+m365 aad user add --displayName "John Doe" --userName "john.doe@contoso.com" --preferredLanguage "nl-BE" --usageLocation BE --forceChangePasswordNextSignIn
+```
+
+Create a user with a manager
+
+```sh
+m365 aad user add --displayName "John Doe" --userName "john.doe@contoso.com" --managerUserName "adele@contoso.com"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "990e2425-f595-43bc-85ed-b89a44093793",
+      "businessPhones": [],
+      "displayName": "John Doe",
+      "givenName": "John",
+      "jobTitle": "Sales Manager",
+      "mail": null,
+      "mobilePhone": null,
+      "officeLocation": "Vosselaar",
+      "preferredLanguage": "nl-BE",
+      "surname": "Doe",
+      "userPrincipalName": "john.doe@contoso.com",
+      "password": "SomePassw0rd"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    businessPhones   : []
+    displayName      : John Doe
+    givenName        : John
+    id               : 990e2425-f595-43bc-85ed-b89a44093793
+    jobTitle         : Sales Manager
+    mail             : null
+    mobilePhone      : null
+    officeLocation   : Vosselaar
+    password         : SomePassw0rd
+    preferredLanguage: nl-BE
+    surname          : Doe
+    userPrincipalName: john.doe@contoso.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,businessPhones,displayName,givenName,jobTitle,mail,mobilePhone,officeLocation,preferredLanguage,surname,userPrincipalName,password
+    990e2425-f595-43bc-85ed-b89a44093793,[],John Doe,John,Sales Manager,,,Vosselaar,nl-BE,Doe,john.doe@contoso.com,SomePassw0rd
+    ```
+
+=== "Markdown"
+
+    ```md
+    # aad user add --displayName "John Doe" --userName "john.doe@contoso.com" --password "SomePassw0rd" --firstName "John" --lastName "Doe" --jobTitle "Sales Manager" --officeLocation "Vosselaar" --preferredLanguage "nl-BE"
+
+    Date: 16/02/2023
+
+    ## John Doe (990e2425-f595-43bc-85ed-b89a44093793)
+
+    Property | Value
+    ---------|-------
+    id | 990e2425-f595-43bc-85ed-b89a44093793
+    businessPhones | []
+    displayName | John Doe
+    givenName | John
+    jobTitle | Sales Manager
+    mail | null
+    mobilePhone | null
+    officeLocation | Vosselaar
+    preferredLanguage | nl-BE
+    surname | Doe
+    userPrincipalName | john.doe@contoso.com
+    password | SomePassw0rd
+    ```

package/docs/docs/cmd/aad/user/user-license-add.md

@@ -0,0 +1,108 @@
+# aad user license add
+
+Assigns a license to a user
+
+## Usage
+
+```sh
+m365 aad user license add [options]
+```
+
+## Options
+
+`--userId [userId]`
+: The ID of the user. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: User principal name of the user. Specify either `userId` or `userName` but not both.
+
+`--ids <ids>`
+: A comma separated list of IDs that specify the licenses to add.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! important
+    The user must have a `usageLocation` value in order to assign a license to it.
+
+## Examples
+
+Assign specific licenses to a specific user by UPN
+
+```sh
+m365 user license add --userName "john.doe@contoso.com" --ids "45715bb8-13f9-4bf6-927f-ef96c102d394,bea13e0c-3828-4daa-a392-28af7ff61a0f"
+```
+
+Assign specific licenses from a specific user by ID
+
+```sh
+m365 user license add --userId "5c241023-2ba5-4ea8-a516-a2481a3e6c51" --ids "45715bb8-13f9-4bf6-927f-ef96c102d394,bea13e0c-3828-4daa-a392-28af7ff61a0f"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "businessPhones": [],
+      "displayName": "John Doe",
+      "givenName": null,
+      "jobTitle": null,
+      "mail": "John@contoso.onmicrosoft.com",
+      "mobilePhone": null,
+      "officeLocation": null,
+      "preferredLanguage": null,
+      "surname": null,
+      "userPrincipalName": "John@contoso.onmicrosoft.com",
+      "id": "eb77fbcf-6fe8-458b-985d-1747284793bc"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    businessPhones   : []
+    displayName      : John Doe
+    givenName        : null
+    id               : eb77fbcf-6fe8-458b-985d-1747284793bc
+    jobTitle         : null
+    mail             : John@contoso.onmicrosoft.com
+    mobilePhone      : null
+    officeLocation   : null
+    preferredLanguage: null
+    surname          : null
+    userPrincipalName: John@contoso.onmicrosoft.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    businessPhones,displayName,givenName,jobTitle,mail,mobilePhone,officeLocation,preferredLanguage,surname,userPrincipalName,id
+    [],John Doe,,,John@contoso.onmicrosoft.com,,,,,John@contoso.onmicrosoft.com,eb77fbcf-6fe8-458b-985d-1747284793bc
+    ```
+
+=== "Markdown"
+
+    ```md
+    # aad user license add --userName "John@contoso.onmicrosoft.com" --ids "f30db892-07e9-47e9-837c-80727f46fd3d,606b54a9-78d8-4298-ad8b-df6ef4481c80"
+
+    Date: 16/2/2023
+
+    ## John Doe (eb77fbcf-6fe8-458b-985d-1747284793bc)
+
+    Property | Value
+    ---------|-------
+    businessPhones | []
+    displayName | John Doe
+    givenName | null
+    jobTitle | null
+    mail | John@contoso.onmicrosoft.com
+    mobilePhone | null
+    officeLocation | null
+    preferredLanguage | null
+    surname | null
+    userPrincipalName | John@contoso.onmicrosoft.com
+    id | eb77fbcf-6fe8-458b-985d-1747284793bc
+    ```

package/docs/docs/cmd/aad/user/user-license-list.md

@@ -0,0 +1,98 @@
+# aad user license list
+
+Lists the license details for a given user
+
+## Usage
+
+```sh
+m365 aad user license list [options]
+```
+
+## Options
+
+`--userId [userId]`
+: The ID of the user. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: User principal name of the user. Specify either `userId` or `userName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! tip
+    If you don't specify any option, the command will list the license details of the current logged in user. This does not work when using application permissions.
+
+## Examples
+
+List license details of the current logged in user.
+
+```sh
+m365 aad user license list
+```
+
+List license details of a specific user by its UPN.
+
+```sh
+m365 aad user license list --userName john.doe@contoso.com
+```
+
+List license details of a specific user by its ID.
+
+```sh
+m365 aad user license list --userId 59f80e08-24b1-41f8-8586-16765fd830d3
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id": "x4s03usaBkSMs5fbAhyttK6cK8RP6rdKlxeBV2I1zKw",
+        "skuId": "c42b9cae-ea4f-4ab7-9717-81576235ccac",
+        "skuPartNumber": "DEVELOPERPACK_E5",
+        "servicePlans": [
+          {
+            "servicePlanId": "7547a3fe-08ee-4ccb-b430-5077c5041653",
+            "servicePlanName": "YAMMER_ENTERPRISE",
+            "provisioningStatus": "Success",
+            "appliesTo": "User"
+          }
+        ]
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id           : x4s03usaBkSMs5fbAhyttK6cK8RP6rdKlxeBV2I1zKw
+    skuId        : c42b9cae-ea4f-4ab7-9717-81576235ccac
+    skuPartNumber: DEVELOPERPACK_E5
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,skuId,skuPartNumber
+    x4s03usaBkSMs5fbAhyttK6cK8RP6rdKlxeBV2I1zKw,c42b9cae-ea4f-4ab7-9717-81576235ccac,DEVELOPERPACK_E5
+    ```
+
+=== "Markdown"
+
+    ```md
+    # aad user license list --userId "0c9c625f-faa9-4c3b-8cd8-d874b869f78c"
+
+    Date: 2/19/2023
+
+    ## x4s03usaBkSMs5fbAhyttK6cK8RP6rdKlxeBV2I1zKw
+
+    Property | Value
+    ---------|-------
+    id | x4s03usaBkSMs5fbAhyttK6cK8RP6rdKlxeBV2I1zKw
+    skuId | c42b9cae-ea4f-4ab7-9717-81576235ccac
+    skuPartNumber | DEVELOPERPACK\_E5
+    servicePlans | [{"servicePlanId":"7547a3fe-08ee-4ccb-b430-5077c5041653","servicePlanName":"YAMMER\_ENTERPRISE","provisioningStatus":"Success","appliesTo":"User"}]
+    ```

package/docs/docs/cmd/aad/user/user-license-remove.md

@@ -0,0 +1,43 @@
+# aad user license remove
+
+Removes a license from a user
+
+## Usage
+
+```sh
+m365 aad user license remove [options]
+```
+
+## Options
+
+`--userId [userId]`
+: The ID of the user. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: 	User principal name of the user. Specify either `userId` or `userName` but not both.
+
+`--ids <ids>`
+: A comma separated list of IDs that specify the licenses to remove.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove specific licenses from a specific user by UPN
+
+```sh
+m365 user license remove --userName "john.doe@contoso.com" --ids "45715bb8-13f9-4bf6-927f-ef96c102d394,bea13e0c-3828-4daa-a392-28af7ff61a0f"
+```
+
+Remove specific licenses from a specific user by ID
+
+```sh
+m365 user license remove --userId 5c241023-2ba5-4ea8-a516-a2481a3e6c51 --ids "45715bb8-13f9-4bf6-927f-ef96c102d394,bea13e0c-3828-4daa-a392-28af7ff61a0f"
+```
+
+## Response
+
+The command won't return a response on success.