@pnp/cli-microsoft365 7.4.0-beta.fce7b64 → 7.5.0-beta.0ae7da4

package/dist/utils/validation.js

@@ -21,6 +21,10 @@ export const validation = {
         const guidRegEx = new RegExp(/^19:[0-9a-zA-Z-_]+(@thread\.v2|@unq\.gbl\.spaces)$/i);
         return guidRegEx.test(guid);
     },
+    isValidUserPrincipalNameArray(upns) {
+        const invalidGuid = upns.find(upn => !this.isValidUserPrincipalName(upn));
+        return invalidGuid || true;
+    },
     isValidUserPrincipalName(upn) {
         const upnRegEx = new RegExp(/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$/i);
         // verify if the upn is a valid upn. @meusername will be replaced in a later stage with the actual username of the logged in user
@@ -317,6 +321,10 @@ export const validation = {
             return true;
         }
         return false;
+    },
+    isValidMailNickname(mailNickname) {
+        const mailNicknameRegEx = new RegExp(/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]*$/i);
+        return mailNicknameRegEx.test(mailNickname);
     }
 };
 //# sourceMappingURL=validation.js.map

package/docs/docs/cmd/adaptivecard/adaptivecard-send.mdx

@@ -47,7 +47,7 @@ The predefined card is automatically adjusted based on which options have been s
 
 If your custom card is a card template (card with placeholders like `${title}`), you can fill it with data either by specifying the complete data object using the `cardData` option, or by passing any number of arbitrary options that will be mapped onto the card. The arbitrary properties should not match any of the global options like `output`, `query`, `debug`, etc. Data options like `title`, `description`, `imageUrl` and `actionUrl` will be mapped onto the card as well.
 
-:::warning Escaping JSON in PowerShell
+:::warning[Escaping JSON in PowerShell]
 
 When using the `--card` and `--cardData` options it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../user-guide/using-cli.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
 

package/docs/docs/cmd/{aad → entra}/administrativeunit/administrativeunit-add.mdx

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# aad administrativeunit add
+# entra administrativeunit add
 
 Creates a new administrative unit
 
 ## Usage
 
+```sh
+m365 entra administrativeunit add [options]
+```
+
+## Alias
+
 ```sh
 m365 aad administrativeunit add [options]
 ```
@@ -40,19 +46,19 @@ To use this command you must be either **Global Administrator** or **Privileged
 Create an administrative unit with a specific display name
 
 ```sh
-m365 aad administrativeunit add --displayName 'Marketing Division'
+m365 entra administrativeunit add --displayName 'Marketing Division'
 ```
 
 Create an administrative unit with a specific display name and description
 
 ```sh
-m365 aad administrativeunit add --displayName 'Marketing Division' --description 'Marketing department administration'
+m365 entra administrativeunit add --displayName 'Marketing Division' --description 'Marketing department administration'
 ```
 
 Create a hidden administrative unit with a specific display name
 
 ```sh
-m365 aad administrativeunit add --displayName 'Marketing Division' --hiddenMembership
+m365 entra administrativeunit add --displayName 'Marketing Division' --hiddenMembership
 ```
 
 ## Response

package/docs/docs/cmd/{aad → entra}/administrativeunit/administrativeunit-get.mdx

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# aad administrativeunit get
+# entra administrativeunit get
 
 Gets information about a specific administrative unit
 
 ## Usage
 
+```sh
+m365 entra administrativeunit get [options]
+```
+
+## Alias
+
 ```sh
 m365 aad administrativeunit get [options]
 ```
@@ -29,13 +35,13 @@ m365 aad administrativeunit get [options]
 Get information about the administrative unit by its id
 
 ```sh
-m365 aad administrativeunit get --id 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
+m365 entra administrativeunit get --id 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
 ```
 
 Get information about the administrative unit by its display name
 
 ```sh
-m365 aad administrativeunit get --displayName 'Marketing Division'
+m365 entra administrativeunit get --displayName 'Marketing Division'
 ```
 
 ## Response

package/docs/docs/cmd/{aad → entra}/administrativeunit/administrativeunit-list.mdx

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# aad administrativeunit list
+# entra administrativeunit list
 
 Retrieves a list of administrative units
 
 ## Usage
 
+```sh
+m365 entra administrativeunit list [options]
+```
+
+## Alias
+
 ```sh
 m365 aad administrativeunit list [options]
 ```
@@ -21,7 +27,7 @@ m365 aad administrativeunit list [options]
 Retrieve a list of administrative units
 
 ```sh
-m365 aad administrativeunit list
+m365 entra administrativeunit list
 ```
 
 ## Response
@@ -65,7 +71,7 @@ m365 aad administrativeunit list
   <TabItem value="Markdown">
 
   ```md
-  # aad administrativeunit list
+  # entra administrativeunit list
 
   Date: 2023-10-16
 

package/docs/docs/cmd/{aad → entra}/administrativeunit/administrativeunit-member-add.mdx

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# aad administrativeunit member add
+# entra administrativeunit member add
 
 Add a member (user, group, or device) to an administrative unit
 
 ## Usage
 
+```sh
+m365 entra administrativeunit member add [options]
+```
+
+## Alias
+
 ```sh
 m365 aad administrativeunit member add [options]
 ```
@@ -55,37 +61,37 @@ To use this command you must be either **Global Administrator** or **Privileged
 Add a single user specified by id to an administrative unit specified by id
 
 ```sh
-m365 aad administrativeunit member add --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --userId 1caf7dcd-7e83-4c3a-94f7-932a1299c844
+m365 entra administrativeunit member add --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --userId 1caf7dcd-7e83-4c3a-94f7-932a1299c844
 ```
 
 Add a single user specified by user principal name to an administrative unit specified by name
 
 ```sh
-m365 aad administrativeunit member add --administrativeUnitName 'Marketing Division' --userName john.doe@contoso.com
+m365 entra administrativeunit member add --administrativeUnitName 'Marketing Division' --userName john.doe@contoso.com
 ```
 
 Add a single group specified by id to an administrative unit specified by id
 
 ```sh
-m365 aad administrativeunit member add --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --groupId b2307a39-e878-458b-bc90-03bc578531d6
+m365 entra administrativeunit member add --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --groupId b2307a39-e878-458b-bc90-03bc578531d6
 ```
 
 Add a single group specified by name to an administrative unit specified by name
 
 ```sh
-m365 aad administrativeunit member add --administrativeUnitName 'Marketing Division' --groupName 'Marketing Group'
+m365 entra administrativeunit member add --administrativeUnitName 'Marketing Division' --groupName 'Marketing Group'
 ```
 
 Add a single device specified by id to an administrative unit specified by id
 
 ```sh
-m365 aad administrativeunit member add --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --deviceId 810c84a8-4a9e-49e6-bf7d-12d183f40d01
+m365 entra administrativeunit member add --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --deviceId 810c84a8-4a9e-49e6-bf7d-12d183f40d01
 ```
 
 Add a single device specified by name to an administrative unit specified by name
 
 ```sh
-m365 aad administrativeunit member add --administrativeUnitName 'Marketing Division' --deviceName 'JohnDoe-PC'
+m365 entra administrativeunit member add --administrativeUnitName 'Marketing Division' --deviceName 'JohnDoe-PC'
 ```
 
 ## More information

package/docs/docs/cmd/{aad → entra}/administrativeunit/administrativeunit-member-get.mdx

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# aad administrativeunit member get
+# entra administrativeunit member get
 
 Retrieves info about a specific member of an administrative unit
 
 ## Usage
 
+```sh
+m365 entra administrativeunit member get [options]
+```
+
+## Alias
+
 ```sh
 m365 aad administrativeunit member get [options]
 ```
@@ -41,13 +47,13 @@ When the `properties` option includes values with a `/`, for example: `manager/d
 Get information about a member specified by id from an administrative unit specified by id
 
 ```sh
-m365 aad administrativeunit member get --id 64131a70-beb9-4ccb-b590-4401e58446ec --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 
+m365 entra administrativeunit member get --id 64131a70-beb9-4ccb-b590-4401e58446ec --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 
 ```
 
 Get information about a member specified by id from an administrative unit specified by name
 
 ```sh
-m365 aad administrativeunit member get --id 64131a70-beb9-4ccb-b590-4401e58446ec --administrativeUnitName 'Marketing Division' 
+m365 entra administrativeunit member get --id 64131a70-beb9-4ccb-b590-4401e58446ec --administrativeUnitName 'Marketing Division' 
 ```
 
 ## Response

package/docs/docs/cmd/{aad → entra}/administrativeunit/administrativeunit-member-list.mdx

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# aad administrativeunit member list
+# entra administrativeunit member list
 
 Retrieves members (users, groups, or devices) of an administrative unit
 
 ## Usage
 
+```sh
+m365 entra administrativeunit member list [options]
+```
+
+## Alias
+
 ```sh
 m365 aad administrativeunit member list [options]
 ```
@@ -44,55 +50,55 @@ When the `properties` option includes values with a `/`, for example: `manager/d
 List members of an administrative unit specified by id
 
 ```sh
-m365 aad administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
+m365 entra administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
 ```
 
 List members of an administrative unit specified by id. For each one return the `id` and the `displayName`
 
 ```sh
-m365 aad administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --properties 'id,displayName'
+m365 entra administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --properties 'id,displayName'
 ```
 
 List members of an administrative unit specified by name
 
 ```sh
-m365 aad administrativeunit member list --administrativeUnitName 'Marketing Division'
+m365 entra administrativeunit member list --administrativeUnitName 'Marketing Division'
 ```
 
 List users of an administrative unit specified by id
 
 ```sh
-m365 aad administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --type user
+m365 entra administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --type user
 ```
 
 List users of an administrative unit specified by id that are guest users
 
 ```sh
-m365 aad administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --type user --filter "userType eq 'Guest'"
+m365 entra administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --type user --filter "userType eq 'Guest'"
 ```
 
 List groups of an administrative unit specified by id
 
 ```sh
-m365 aad administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --type group
+m365 entra administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --type group
 ```
 
 List groups of an administrative unit specified by id and include owners names, for each member return the `id` and the `displayName`
 
 ```sh
-m365 aad administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --type group --properties 'id,displayName,owners/displayName'
+m365 entra administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --type group --properties 'id,displayName,owners/displayName'
 ```
 
 List devices of an administrative unit specified by id
 
 ```sh
-m365 aad administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --type device
+m365 entra administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --type device
 ```
 
 List devices with linux operating system of an administrative unit specified by id
 
 ```sh
-m365 aad administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --type device --filter "operatingSystem eq 'linux'"
+m365 entra administrativeunit member list --administrativeUnitId 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7 --type device --filter "operatingSystem eq 'linux'"
 ```
 
 ## Response

package/docs/docs/cmd/{aad → entra}/administrativeunit/administrativeunit-remove.mdx

@@ -1,11 +1,17 @@
 import Global from '/docs/cmd/_global.mdx';
 
-# aad administrativeunit remove
+# entra administrativeunit remove
 
 Removes an administrative unit
 
 ## Usage
 
+```sh
+m365 entra administrativeunit remove [options]
+```
+
+## Alias
+
 ```sh
 m365 aad administrativeunit remove [options]
 ```
@@ -38,13 +44,13 @@ To use this command you must be either **Global Administrator** or **Privileged
 Remove an administrative unit by its id
 
 ```sh
-m365 aad administrativeunit remove --id 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
+m365 entra administrativeunit remove --id 03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7
 ```
 
 Remove an administrative unit by it displayName
 
 ```sh
-m365 aad administrativeunit remove --displayName 'Marketing Division'
+m365 entra administrativeunit remove --displayName 'Marketing Division'
 ```
 
 ## Response

package/docs/docs/cmd/entra/administrativeunit/administrativeunit-roleassignment-add.mdx

@@ -0,0 +1,116 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra administrativeunit roleassignment add
+
+Assigns a Microsoft Entra role with administrative unit scope to a user
+
+## Usage
+
+```sh
+m365 entra administrativeunit roleassignment add [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --administrativeUnitId [administrativeUnitId]`
+: The id of the administrative unit. Specify either `administrativeUnitId` or `administrativeUnitName`.
+
+`-n, --administrativeUnitName [administrativeUnitName]`
+: The name of the administrative unit. Specify either `administrativeUnitId` or `administrativeUnitName`.
+
+`--roleDefinitionId [roleDefinitionId]`
+: The id of the role definition that the member is in. Specify either `roleDefinitionId` or `roleDefinitionName`.
+
+`--roleDefinitionName [roleDefinitionName]`
+: The name of the role definition that the member is in. Specify either `roleDefinitionId` or `roleDefinitionName`.
+
+`--userId [userId]`
+: The id of the user that is a member of the scoped role. Specify either `userId` or `userName`.
+
+`--userName [userName]`
+: The name of the user that is a member of the scoped role. Specify either `userId` or `userName`.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **Global Administrator** or **Privileged Role Administrator**.
+
+:::
+
+## Examples
+
+Assign a role definition specified by id to a user specified by id for an administrative unit specified by id
+
+```sh
+m365 entra administrativeunit roleassignment add --administrativeUnitId 81bb36e4-f4c6-4984-8e56-d4f8feae9e09 --roleDefinitionId 4d6ac14f-3453-41d0-bef9-a3e0c569773a --userId 5f91f951-7305-4a27-9b63-7b00906de09f
+```
+
+Assign a role definition specified by name to a user specified by name for an administrative unit specified by name
+
+```sh
+m365 entra administrativeunit roleassignment add --administrativeUnitName 'Marketing Division' --roleDefinitionName 'License Administrator' --userName 'john.doe@contoso.com'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "5wuT_mJe20eRr5jDpJo4sVH5kV8FcydKm2N7AJBt4J_kNruBxvSESY5W1Pj-rp4J-2",
+    "principalId": "5f91f951-7305-4a27-9b63-7b00906de09f",
+    "directoryScopeId": "/administrativeUnits/81bb36e4-f4c6-4984-8e56-d4f8feae9e09",
+    "roleDefinitionId": "4d6ac14f-3453-41d0-bef9-a3e0c569773a"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  directoryScopeId: /administrativeUnits/81bb36e4-f4c6-4984-8e56-d4f8feae9e09
+  id              : 4yeYchSc90m7G5YI8Va7uFH5kV8FcydKm2N7AJBt4J_kNruBxvSESY5W1Pj-rp4J-2
+  principalId     : 5f91f951-7305-4a27-9b63-7b00906de09f
+  roleDefinitionId: 4d6ac14f-3453-41d0-bef9-a3e0c569773a
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,principalId,directoryScopeId,roleDefinitionId
+  UB-K8uf2cUWBi2oS8q9rbFH5kV8FcydKm2N7AJBt4J_kNruBxvSESY5W1Pj-rp4J-2,5f91f951-7305-4a27-9b63-7b00906de09f,/administrativeUnits/81bb36e4-f4c6-4984-8e56-d4f8feae9e09,4d6ac14f-3453-41d0-bef9-a3e0c569773a
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra administrativeunit roleassignment add --administrativeUnitId "81bb36e4-f4c6-4984-8e56-d4f8feae9e09" --roleDefinitionId "4d6ac14f-3453-41d0-bef9-a3e0c569773a" --userId "5f91f951-7305-4a27-9b63-7b00906de09f"
+
+  Date: 11/16/2023
+
+  ## T8FqTVM00EG--aPgxWl3OlH5kV8FcydKm2N7AJBt4J_kNruBxvSESY5W1Pj-rp4J-2
+
+  Property | Value
+  ---------|-------
+  id | T8FqTVM00EG--aPgxWl3OlH5kV8FcydKm2N7AJBt4J\_kNruBxvSESY5W1Pj-rp4J-2
+  principalId | 5f91f951-7305-4a27-9b63-7b00906de09f
+  directoryScopeId | /administrativeUnits/81bb36e4-f4c6-4984-8e56-d4f8feae9e09
+  roleDefinitionId | 4d6ac14f-3453-41d0-bef9-a3e0c569773a
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- [Roles with administrative unit scope](https://learn.microsoft.com/entra/identity/role-based-access-control/admin-units-assign-roles#roles-that-can-be-assigned-with-administrative-unit-scope)