@pnp/cli-microsoft365 7.3.0-beta.e0b37b9 → 7.4.0-beta.2324d53

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

@@ -4,7 +4,6 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _SpoPageAddCommand_instances, _SpoPageAddCommand_initTelemetry, _SpoPageAddCommand_initOptions, _SpoPageAddCommand_initValidators;
-import { Auth } from '../../../../Auth.js';
 import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
@@ -31,11 +30,9 @@ class SpoPageAddCommand extends SpoCommand {
         __classPrivateFieldGet(this, _SpoPageAddCommand_instances, "m", _SpoPageAddCommand_initValidators).call(this);
     }
     async commandAction(logger, args) {
-        const resource = Auth.getResourceFromUrl(args.options.webUrl);
         let requestDigest = '';
         let itemId = '';
         let pageName = args.options.name;
-        const serverRelativeSiteUrl = urlUtil.getServerRelativeSiteUrl(args.options.webUrl);
         const fileNameWithoutExtension = pageName.replace('.aspx', '');
         let bannerImageUrl = '';
         let canvasContent1 = '';
@@ -52,39 +49,22 @@ class SpoPageAddCommand extends SpoCommand {
             const reqDigest = await spo.getRequestDigest(args.options.webUrl);
             requestDigest = reqDigest.FormDigestValue;
             let requestOptions = {
-                url: `${args.options.webUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${serverRelativeSiteUrl}/sitepages')/files/AddTemplateFile`,
+                url: `${args.options.webUrl}/_api/sitepages/pages`,
+                responseType: 'json',
                 headers: {
-                    'X-RequestDigest': requestDigest,
                     'content-type': 'application/json;odata=nometadata',
                     accept: 'application/json;odata=nometadata'
                 },
                 data: {
-                    urlOfFile: `${serverRelativeSiteUrl}/sitepages/${pageName}`,
-                    templateFileType: 3
-                },
-                responseType: 'json'
+                    PageLayoutType: args.options.layoutType || 'Article',
+                    Name: pageName,
+                    PromotedState: args.options.promoteAs === 'NewsPage' ? 2 : 0,
+                    Title: pageTitle
+                }
             };
             const template = await request.post(requestOptions);
             itemId = template.UniqueId;
             const listItemId = await this.getFileListItemId(args.options.webUrl, serverRelativeFileUrl);
-            const layoutType = args.options.layoutType || 'Article';
-            const listItemSetOptions = {
-                webUrl: args.options.webUrl,
-                listUrl: listServerRelativeUrl,
-                id: listItemId,
-                systemUpdate: true,
-                ContentTypeId: '0x0101009D1CB255DA76424F860D91F20E6C4118',
-                Title: pageTitle,
-                ClientSideApplicationId: 'b6917cb1-93a0-4b97-a84d-7cf49975d4ec',
-                PageLayoutType: layoutType,
-                verbose: this.verbose,
-                debug: this.debug
-            };
-            if (args.options.layoutType === 'Article') {
-                listItemSetOptions.PromotedState = 0;
-                listItemSetOptions.BannerImageUrl = `${resource}/_layouts/15/images/sitepagethumbnail.png, /_layouts/15/images/sitepagethumbnail.png`;
-            }
-            await cli.executeCommand(spoListItemSetCommand, { options: { ...listItemSetOptions, _: [] } });
             const pageProps = await Page.checkout(pageName, args.options.webUrl, logger, this.debug, this.verbose);
             if (pageProps) {
                 pageId = pageProps.Id;
@@ -117,7 +97,6 @@ class SpoPageAddCommand extends SpoCommand {
                             listUrl: listServerRelativeUrl,
                             id: listItemId,
                             systemUpdate: true,
-                            PromotedState: 2,
                             FirstPublishedDate: new Date().toISOString(),
                             verbose: this.verbose,
                             debug: this.debug

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

@@ -12,7 +12,7 @@ import { formatting } from '../../../../utils/formatting.js';
 import { spo } from '../../../../utils/spo.js';
 import { urlUtil } from '../../../../utils/urlUtil.js';
 import { validation } from '../../../../utils/validation.js';
-import aadM365GroupSetCommand from '../../../aad/commands/m365group/m365group-set.js';
+import aadM365GroupSetCommand from '../../../entra/commands/m365group/m365group-set.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
 import { SharingCapabilities } from '../site/SharingCapabilities.js';

package/dist/m365/teams/commands/app/app-install.js

@@ -8,7 +8,7 @@ import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
 import { validation } from '../../../../utils/validation.js';
-import aadUserGetCommand from '../../../aad/commands/user/user-get.js';
+import aadUserGetCommand from '../../../entra/commands/user/user-get.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
 class TeamsAppInstallCommand extends GraphCommand {

package/dist/m365/teams/commands/meeting/meeting-attendancereport-list.js

@@ -9,7 +9,7 @@ import { cli } from '../../../../cli/cli.js';
 import { accessToken } from '../../../../utils/accessToken.js';
 import { odata } from '../../../../utils/odata.js';
 import { validation } from '../../../../utils/validation.js';
-import aadUserGetCommand from '../../../aad/commands/user/user-get.js';
+import aadUserGetCommand from '../../../entra/commands/user/user-get.js';
 import GraphCommand from "../../../base/GraphCommand.js";
 import commands from '../../commands.js';
 class TeamsMeetingAttendancereportListCommand extends GraphCommand {

package/dist/utils/aadAdministrativeUnit.js

@@ -1,7 +1,6 @@
-import { odata } from "./odata.js";
-import { formatting } from "./formatting.js";
-import { cli } from "../cli/cli.js";
-const graphResource = 'https://graph.microsoft.com';
+import { odata } from './odata.js';
+import { formatting } from './formatting.js';
+import { cli } from '../cli/cli.js';
 export const aadAdministrativeUnit = {
     /**
      * Get an administrative unit by its display name.
@@ -10,6 +9,7 @@ export const aadAdministrativeUnit = {
      * @throws Error when administrative unit was not found.
      */
     async getAdministrativeUnitByDisplayName(displayName) {
+        const graphResource = 'https://graph.microsoft.com';
         const administrativeUnits = await odata.getAllItems(`${graphResource}/v1.0/directory/administrativeUnits?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'`);
         if (administrativeUnits.length === 0) {
             throw `The specified administrative unit '${displayName}' does not exist.`;

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/entra/administrativeunit/administrativeunit-member-get.mdx

@@ -0,0 +1,136 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# 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]
+```
+
+## Options
+
+```md definition-list
+`-i, --id <id>`
+: The id of a member to be retrieved.
+
+`-u, --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`.
+
+`-p, --properties [properties]`
+: Comma-separated list of properties to retrieve.
+```
+
+<Global />
+
+## Remarks
+
+To get the member of a hidden membership in an administrative unit, the `Member.Read.Hidden` permission is required.
+
+When the `properties` option includes values with a `/`, for example: `manager/displayName`, an additional `$expand` query parameter will be included on manager.
+
+## Examples
+
+Get information about a member specified by id from an administrative unit specified by id
+
+```sh
+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 entra administrativeunit member get --id 64131a70-beb9-4ccb-b590-4401e58446ec --administrativeUnitName 'Marketing Division' 
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "64131a70-beb9-4ccb-b590-4401e58446ec",
+    "businessPhones": [
+      "+20 255501070"
+    ],
+    "displayName": "Pradeep Gupta",
+    "givenName": "Pradeep",
+    "jobTitle": "Accountant",
+    "mail": "PradeepG@contoso.com",
+    "mobilePhone": null,
+    "officeLocation": "98/2202",
+    "preferredLanguage": "en-US",
+    "surname": "Gupta",
+    "userPrincipalName": "PradeepG@contoso.com",
+    "type": "user"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  businessPhones   : ["+20 255501070"]
+  displayName      : Pradeep Gupta
+  givenName        : Pradeep
+  id               : 64131a70-beb9-4ccb-b590-4401e58446ec
+  jobTitle         : Accountant
+  mail             : PradeepG@contoso.com
+  mobilePhone      : null
+  officeLocation   : 98/2202
+  preferredLanguage: en-US
+  surname          : Gupta
+  type             : user
+  userPrincipalName: PradeepG@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,displayName,givenName,jobTitle,mail,officeLocation,preferredLanguage,surname,userPrincipalName,type
+  64131a70-beb9-4ccb-b590-4401e58446ec,Pradeep Gupta,Pradeep,Accountant,PradeepG@contoso.com,98/2202,en-US,Gupta,PradeepG@contoso.com,user
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  Date: 11/10/2023
+
+  ## Pradeep Gupta (64131a70-beb9-4ccb-b590-4401e58446ec)
+
+  Property | Value
+  ---------|-------
+  id | 64131a70-beb9-4ccb-b590-4401e58446ec
+  displayName | Pradeep Gupta
+  givenName | Pradeep
+  jobTitle | Accountant
+  mail | PradeepG@contoso.com
+  officeLocation | 98/2202
+  preferredLanguage | en-US
+  surname | Gupta
+  userPrincipalName | PradeepG@contoso.com
+  type | user
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Administrative units: https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units

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