@pnp/cli-microsoft365 7.3.0-beta.01256d2 → 7.3.0-beta.1c23854

package/docs/docs/cmd/aad/administrativeunit/administrativeunit-member-list.mdx

@@ -0,0 +1,312 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# aad administrativeunit member list
+
+Retrieves members (users, groups, or devices) of an administrative unit
+
+## Usage
+
+```sh
+m365 aad administrativeunit member list [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`.
+
+`-t, --type [type]`
+: When specified, the command returns only objects of specified type. Allowed values are `user`, `group` and `device`.
+
+`-p, --properties [properties]`
+: Comma-separated list of properties to retrieve.
+
+`-f, --filter [filter]`
+: OData filter to use to query the list of members with. Applied only when `type` is specified.
+```
+
+<Global />
+
+## Remarks
+
+To list the members 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
+
+List members of an administrative unit specified by id
+
+```sh
+m365 aad 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'
+```
+
+List members of an administrative unit specified by name
+
+```sh
+m365 aad 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
+```
+
+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'"
+```
+
+List groups of an administrative unit specified by id
+
+```sh
+m365 aad 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'
+```
+
+List devices of an administrative unit specified by id
+
+```sh
+m365 aad 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'"
+```
+
+## 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"
+    },
+    {
+      "id": "c121c70b-deb1-43f7-8298-9111bf3036b4",
+      "deletedDateTime": null,
+      "classification": null,
+      "createdDateTime": "2023-02-22T06:39:13Z",
+      "creationOptions": [
+        "Team",
+        "ExchangeProvisioningFlags:3552"
+      ],
+      "description": "Welcome to the team that we've assembled to create the Mark 8.",
+      "displayName": "Mark 8 Project Team",
+      "expirationDateTime": null,
+      "groupTypes": [
+        "Unified"
+      ],
+      "isAssignableToRole": null,
+      "mail": "Mark8ProjectTeam@contoso.com",
+      "mailEnabled": true,
+      "mailNickname": "Mark8ProjectTeam",
+      "membershipRule": null,
+      "membershipRuleProcessingState": null,
+      "onPremisesDomainName": null,
+      "onPremisesLastSyncDateTime": null,
+      "onPremisesNetBiosName": null,
+      "onPremisesSamAccountName": null,
+      "onPremisesSecurityIdentifier": null,
+      "onPremisesSyncEnabled": null,
+      "preferredDataLocation": null,
+      "preferredLanguage": null,
+      "proxyAddresses": [
+        "SPO:SPO_e9b87117-c271-4ea9-8bf8-ec0a52253c50@SPO_70cf0eca-e1e8-4d78-9d03-62ecf811dfc2",
+        "SMTP:Mark8ProjectTeam@contoso.com"
+      ],
+      "renewedDateTime": "2023-02-22T06:39:13Z",
+      "resourceBehaviorOptions": [
+        "HideGroupInOutlook",
+        "SubscribeMembersToCalendarEventsDisabled",
+        "WelcomeEmailDisabled"
+      ],
+      "resourceProvisioningOptions": [
+        "Team"
+      ],
+      "securityEnabled": false,
+      "securityIdentifier": "S-1-12-1-3240216331-1140317873-294754434-3023450303",
+      "theme": null,
+      "visibility": "Public",
+      "onPremisesProvisioningErrors": [],
+      "serviceProvisioningErrors": [],
+      "type": "group"
+    },
+    {
+      "id": "3f9fd7c3-73ad-4ce3-b053-76bb8252964d",
+      "deletedDateTime": null,
+      "accountEnabled": true,
+      "approximateLastSignInDateTime": null,
+      "complianceExpirationDateTime": null,
+      "createdDateTime": "2023-11-06T06:18:26Z",
+      "deviceCategory": null,
+      "deviceId": "4c299165-6e8f-4b45-a5ba-c5d250a707ff",
+      "deviceMetadata": null,
+      "deviceOwnership": null,
+      "deviceVersion": null,
+      "displayName": "AdeleVence-PC",
+      "domainName": null,
+      "enrollmentProfileName": null,
+      "enrollmentType": null,
+      "externalSourceName": null,
+      "isCompliant": null,
+      "isManaged": null,
+      "isRooted": null,
+      "managementType": null,
+      "manufacturer": null,
+      "mdmAppId": null,
+      "model": null,
+      "onPremisesLastSyncDateTime": null,
+      "onPremisesSyncEnabled": null,
+      "operatingSystem": "windows",
+      "operatingSystemVersion": "10",
+      "physicalIds": [],
+      "profileType": null,
+      "registrationDateTime": null,
+      "sourceType": null,
+      "systemLabels": [],
+      "trustType": null,
+      "extensionAttributes": {
+        "extensionAttribute1": null,
+        "extensionAttribute2": null,
+        "extensionAttribute3": null,
+        "extensionAttribute4": null,
+        "extensionAttribute5": null,
+        "extensionAttribute6": null,
+        "extensionAttribute7": null,
+        "extensionAttribute8": null,
+        "extensionAttribute9": null,
+        "extensionAttribute10": null,
+        "extensionAttribute11": null,
+        "extensionAttribute12": null,
+        "extensionAttribute13": null,
+        "extensionAttribute14": null,
+        "extensionAttribute15": null
+      },
+      "alternativeSecurityIds": [
+        {
+          "type": 2,
+          "identityProvider": null,
+          "key": "Y3YxN2E1MWFlYw=="
+        }
+      ],
+      "type": "device"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                    displayName
+  ------------------------------------  -------------------
+  64131a70-beb9-4ccb-b590-4401e58446ec  Pradeep Gupta
+  c121c70b-deb1-43f7-8298-9111bf3036b4  Mark 8 Project Team
+  3f9fd7c3-73ad-4ce3-b053-76bb8252964d  AdeleVence-PC
+  ```
+
+  </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
+  c121c70b-deb1-43f7-8298-9111bf3036b4,Mark 8 Project Team,,,Mark8ProjectTeam@contoso.com,,,,,group
+  3f9fd7c3-73ad-4ce3-b053-76bb8252964d,AdeleVence-PC,,,,,,,,device
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  Date: 11/9/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
+
+  ## Mark 8 Project Team (c121c70b-deb1-43f7-8298-9111bf3036b4)
+
+  Property | Value
+  ---------|-------
+  id | c121c70b-deb1-43f7-8298-9111bf3036b4
+  createdDateTime | 2023-02-22T06:39:13Z
+  description | Welcome to the team that we've assembled to create the Mark 8.
+  displayName | Mark 8 Project Team
+  mail | Mark8ProjectTeam@contoso.com
+  mailEnabled | true
+  mailNickname | Mark8ProjectTeam
+  renewedDateTime | 2023-02-22T06:39:13Z
+  securityEnabled | false
+  securityIdentifier | S-1-12-1-3240216331-1140317873-294754434-3023450303
+  visibility | Public
+  type | group
+
+  ## AdeleVence-PC (3f9fd7c3-73ad-4ce3-b053-76bb8252964d)
+
+  Property | Value
+  ---------|-------
+  id | 3f9fd7c3-73ad-4ce3-b053-76bb8252964d
+  accountEnabled | true
+  createdDateTime | 2023-11-09T06:18:26Z
+  deviceId | 4c299165-6e8f-4b45-a5ba-c5d250a707ff
+  displayName | AdeleVence-PC
+  operatingSystem | windows
+  operatingSystemVersion | 10
+  type | device
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Administrative units: https://learn.microsoft.com/entra/identity/role-based-access-control/administrative-units

package/docs/docs/cmd/aad/app/app-permission-add.mdx

@@ -0,0 +1,62 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# aad app permission add
+
+Adds the specified application and/or delegated permissions to a specified Entra ID (Azure AD) app
+
+## Usage
+
+```sh
+m365 aad app permission add [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --appId [appId]`
+: Client ID of the Entra ID (Azure AD) app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
+
+`--appObjectId [appObjectId]`
+: Object ID of the Entra ID (Azure AD) app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
+
+`-a, --applicationPermissions [applicationPermissions]`
+: Space-separated list of application permissions to add. Specify at least `applicationPermissions` or `delegatedPermissions`.
+
+`-d, --delegatedPermissions [delegatedPermissions]`
+: Space-separated list of delegated permissions to add. Specify at least `applicationPermissions` or `delegatedPermissions`.
+
+`--grantAdminConsent`
+: When specified, grants application & delegated permissions through admin consent.
+```
+
+<Global />
+
+## Remarks
+
+Scopes/Roles to grant must be fully-qualified so that we can disambiguate them between the different resources.
+
+## Examples
+
+Grant multiple delegated API permissions to an Entra ID (Azure AD) app specified by client id
+
+```sh
+m365 aad app permission add --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --delegatedPermissions 'https://management.azure.com/user_impersonation https://service.flow.microsoft.com/Flows.Read.All https://graph.microsoft.com/Agreement.Read.All'
+```
+
+Grant multiple delegated API permissions to an Entra ID (Azure AD) app specified by object id
+
+```sh
+m365 aad app permission add --appObjectId 'e0306bb2-bf0b-4cc5-a845-a0b2cf11f690' --delegatedPermissions 'https://management.azure.com/user_impersonation https://service.flow.microsoft.com/Flows.Read.All https://graph.microsoft.com/Agreement.Read.All'
+```
+
+Grant multiple app-only permissions to an Entra ID (Azure AD) app specified by client id and grant admin consent
+
+```sh
+m365 aad app permission add --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --applicationPermissions 'https://graph.microsoft.com/Sites.FullControl.All https://microsoft.sharepoint-df.com/Sites.FullControl.All' --grandAdminConsent
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/aad/user/user-password-validate.mdx

@@ -23,7 +23,7 @@ m365 aad user password validate [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 
@@ -100,4 +100,4 @@ m365 aad user password validate --password "cli365P@ssW0rd"
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>

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.
 
-:::caution 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/external/connection/connection-doctor.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # external connection doctor
 
@@ -18,6 +20,7 @@ m365 external connection doctor [options]
 
 `--ux [ux]`
 : Microsoft 365 experience for which to check compatibility. Allowed values `copilot`, `search`, `all` (default)
+```
 
 <Global />
 

package/docs/docs/cmd/flow/environment/environment-get.mdx

@@ -23,7 +23,7 @@ m365 flow environment get [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/flow/environment/environment-list.mdx

@@ -18,7 +18,7 @@ m365 flow environment list [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/flow/flow-disable.mdx

@@ -27,7 +27,7 @@ m365 flow disable [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/flow/flow-enable.mdx

@@ -27,7 +27,7 @@ m365 flow enable [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/flow/flow-export.mdx

@@ -42,7 +42,7 @@ m365 flow export [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/flow/flow-get.mdx

@@ -29,7 +29,7 @@ m365 flow get [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/flow/flow-list.mdx

@@ -32,7 +32,7 @@ m365 flow list [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/flow/run/run-cancel.mdx

@@ -30,7 +30,7 @@ m365 flow run cancel [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/flow/run/run-get.mdx

@@ -32,7 +32,7 @@ m365 flow run get [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/flow/run/run-list.mdx

@@ -38,7 +38,7 @@ m365 flow run list [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/flow/run/run-resubmit.mdx

@@ -30,7 +30,7 @@ m365 flow run resubmit [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/graph/changelog/changelog-list.mdx

@@ -35,7 +35,7 @@ m365 graph changelog list [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/graph/schemaextension/schemaextension-add.mdx

@@ -49,7 +49,7 @@ The schema extension owner is the ID of the Azure AD application that is the own
 
 The target types are the set of Microsoft Graph resource types (that support schema extensions) that this schema extension definition can be applied to. This option is specified as a comma-separated list
 
-:::caution Escaping JSON in PowerShell
+:::warning Escaping JSON in PowerShell
 
 When using the `--properties` option 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/graph/schemaextension/schemaextension-set.mdx

@@ -40,7 +40,7 @@ The lifecycle state of the schema extension. The initial state upon creation is
 Possible states transitions are from `InDevelopment` to `Available` and `Available` to `Deprecated`.
 The target types are the set of Microsoft Graph resource types (that support schema extensions) that this schema extension definition can be applied to. This option is specified as a comma-separated list.
 
-:::caution Escaping JSON in PowerShell
+:::warning Escaping JSON in PowerShell
 
 When using the `--properties` option 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/pa/app/app-get.mdx

@@ -26,7 +26,7 @@ m365 pa app get [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reaches general availability.
 

package/docs/docs/cmd/pa/app/app-list.mdx

@@ -26,7 +26,7 @@ m365 pa app list [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reaches general availability.
 

package/docs/docs/cmd/pa/connector/connector-export.mdx

@@ -33,7 +33,7 @@ m365 flow connector export
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/pa/connector/connector-list.mdx

@@ -29,7 +29,7 @@ m365 flow connector list
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/pa/environment/environment-get.mdx

@@ -23,7 +23,7 @@ m365 pa environment get [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/pa/environment/environment-list.mdx

@@ -18,7 +18,7 @@ m365 pa environment list [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/planner/bucket/bucket-add.mdx

@@ -41,7 +41,7 @@ m365 planner bucket add [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 When using `rosterId`, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/planner/bucket/bucket-get.mdx

@@ -41,7 +41,7 @@ m365 planner bucket get [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 When using `rosterId`, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/planner/bucket/bucket-list.mdx

@@ -35,7 +35,7 @@ m365 planner bucket list [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 When using `rosterId`, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/planner/bucket/bucket-remove.mdx

@@ -42,7 +42,7 @@ m365 planner bucket remove [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 When using `rosterId`, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 

package/docs/docs/cmd/planner/bucket/bucket-set.mdx

@@ -45,7 +45,7 @@ m365 planner bucket set [options]
 
 ## Remarks
 
-:::caution
+:::warning
 
 When using `rosterId`, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.