@pnp/cli-microsoft365 6.8.0-beta.f473be5 → 6.9.0-beta.1cd2525

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

@@ -0,0 +1,225 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# app get
+
+Retrieves information about the current Azure AD app
+
+## Usage
+
+```sh
+m365 app get [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve information for.
+```
+
+<Global />
+
+## Remarks
+
+Use this command to quickly look up information for the Azure AD application registration registered in the .m365rc.json file in your current project (folder).
+
+If you have multiple apps registered in your .m365rc.json file, you can specify the app for which you'd like to retrieve permissions using the `--appId` option. If you don't specify the app using the `--appId` option, you'll be prompted to select one of the applications from your .m365rc.json file.
+
+## Examples
+
+Retrieve information about your current Azure AD app.
+
+```sh
+m365 app get
+```
+
+Retrieve information about the Azure AD app with client ID specified in the _.m365rc.json_ file.
+
+```sh
+m365 app get --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "b3241f2a-6551-43d4-a72f-0d02ccfeb77f",
+    "deletedDateTime": null,
+    "appId": "02f9ff8c-b79e-4552-bdda-4facd74d6df1",
+    "applicationTemplateId": null,
+    "disabledByMicrosoftStatus": null,
+    "createdDateTime": "2022-10-28T21:20:57Z",
+    "displayName": "My AAD app",
+    "description": null,
+    "groupMembershipClaims": null,
+    "identifierUris": [],
+    "isDeviceOnlyAuthSupported": null,
+    "isFallbackPublicClient": null,
+    "notes": null,
+    "publisherDomain": "contoso.onmicrosoft.com",
+    "serviceManagementReference": null,
+    "signInAudience": "AzureADMyOrg",
+    "tags": [],
+    "tokenEncryptionKeyId": null,
+    "samlMetadataUrl": null,
+    "defaultRedirectUri": null,
+    "certification": null,
+    "optionalClaims": null,
+    "addIns": [],
+    "api": {
+      "acceptMappedClaims": null,
+      "knownClientApplications": [],
+      "requestedAccessTokenVersion": null,
+      "oauth2PermissionScopes": [],
+      "preAuthorizedApplications": []
+    },
+    "appRoles": [
+      {
+        "allowedMemberTypes": [
+          "User"
+        ],
+        "description": "Managers",
+        "displayName": "Managers",
+        "id": "d7c46856-8a66-485a-9047-098eba08b9a3",
+        "isEnabled": true,
+        "origin": "Application",
+        "value": "managers"
+      }
+    ],
+    "info": {
+      "logoUrl": null,
+      "marketingUrl": null,
+      "privacyStatementUrl": null,
+      "supportUrl": null,
+      "termsOfServiceUrl": null
+    },
+    "keyCredentials": [],
+    "parentalControlSettings": {
+      "countriesBlockedForMinors": [],
+      "legalAgeGroupRule": "Allow"
+    },
+    "passwordCredentials": [],
+    "publicClient": {
+      "redirectUris": []
+    },
+    "requiredResourceAccess": [
+      {
+        "resourceAppId": "b55b276d-2b09-4ad2-8de5-f09cf24ffba9",
+        "resourceAccess": [
+          {
+            "id": "162b1576-a2b2-458d-b7b9-04481911b4ef",
+            "type": "Role"
+          }
+        ]
+      },
+      {
+        "resourceAppId": "00000005-0000-0ff1-ce00-000000000000",
+        "resourceAccess": [
+          {
+            "id": "8e5870bb-8808-44dc-8e10-c509ed919ddd",
+            "type": "Scope"
+          },
+          {
+            "id": "5db81a03-0de0-432b-b31e-71d57c8d2e0b",
+            "type": "Scope"
+          }
+        ]
+      }
+    ],
+    "verifiedPublisher": {
+      "displayName": null,
+      "verifiedPublisherId": null,
+      "addedDateTime": null
+    },
+    "web": {
+      "homePageUrl": null,
+      "logoutUrl": null,
+      "redirectUris": [],
+      "implicitGrantSettings": {
+        "enableAccessTokenIssuance": false,
+        "enableIdTokenIssuance": false
+      },
+      "redirectUriSettings": []
+    },
+    "spa": {
+      "redirectUris": []
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  addIns                    : []
+  api                       : {"acceptMappedClaims":null,"knownClientApplications":[],"requestedAccessTokenVersion":null,"oauth2PermissionScopes":[],"preAuthorizedApplications":[]}
+  appId                     : 02f9ff8c-b79e-4552-bdda-4facd74d6df1
+  appRoles                  : [{"allowedMemberTypes":["User"],"description":"Managers","displayName":"Managers","id":"d7c46856-8a66-485a-9047-098eba08b9a3","isEnabled":true,"origin":"Application","value":"managers"}]
+  applicationTemplateId     : null
+  certification             : null
+  createdDateTime           : 2022-10-28T21:20:57Z
+  defaultRedirectUri        : null
+  deletedDateTime           : null
+  description               : null
+  disabledByMicrosoftStatus : null
+  displayName               : My AAD app
+  groupMembershipClaims     : null
+  id                        : b3241f2a-6551-43d4-a72f-0d02ccfeb77f
+  identifierUris            : []
+  info                      : {"logoUrl":null,"marketingUrl":null,"privacyStatementUrl":null,"supportUrl":null,"termsOfServiceUrl":null}
+  isDeviceOnlyAuthSupported : null
+  isFallbackPublicClient    : null
+  keyCredentials            : []
+  notes                     : null
+  optionalClaims            : null
+  parentalControlSettings   : {"countriesBlockedForMinors":[],"legalAgeGroupRule":"Allow"}
+  passwordCredentials       : []
+  publicClient              : {"redirectUris":[]}
+  publisherDomain           : contoso.onmicrosoft.com
+  requiredResourceAccess    : [{"resourceAppId":"b55b276d-2b09-4ad2-8de5-f09cf24ffba9","resourceAccess":[{"id":"162b1576-a2b2-458d-b7b9-04481911b4ef","type":"Role"}]},{"resourceAppId":"00000005-0000-0ff1-ce00-000000000000","resourceAccess":[{"id":"8e5870bb-8808-44dc-8e10-c509ed919ddd","type":"Scope"},{"id":"5db81a03-0de0-432b-b31e-71d57c8d2e0b","type":"Scope"}]}]
+  samlMetadataUrl           : null
+  serviceManagementReference: null
+  signInAudience            : AzureADMyOrg
+  spa                       : {"redirectUris":[]}
+  tags                      : []
+  tokenEncryptionKeyId      : null
+  verifiedPublisher         : {"displayName":null,"verifiedPublisherId":null,"addedDateTime":null}
+  web                       : {"homePageUrl":null,"logoutUrl":null,"redirectUris":[],"implicitGrantSettings":{"enableAccessTokenIssuance":false,"enableIdTokenIssuance":false},"redirectUriSettings":[]}
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,deletedDateTime,appId,applicationTemplateId,disabledByMicrosoftStatus,createdDateTime,displayName,description,groupMembershipClaims,identifierUris,isDeviceOnlyAuthSupported,isFallbackPublicClient,notes,publisherDomain,serviceManagementReference,signInAudience,tags,tokenEncryptionKeyId,samlMetadataUrl,defaultRedirectUri,certification,optionalClaims,addIns,api,appRoles,info,keyCredentials,parentalControlSettings,passwordCredentials,publicClient,requiredResourceAccess,verifiedPublisher,web,spa
+  b3241f2a-6551-43d4-a72f-0d02ccfeb77f,,02f9ff8c-b79e-4552-bdda-4facd74d6df1,,,2022-10-28T21:20:57Z,My AAD app,,,[],,,,contoso.onmicrosoft.com,,AzureADMyOrg,[],,,,,,[],"{""acceptMappedClaims"":null,""knownClientApplications"":[],""requestedAccessTokenVersion"":null,""oauth2PermissionScopes"":[],""preAuthorizedApplications"":[]}","[{""allowedMemberTypes"":[""User""],""description"":""Managers"",""displayName"":""Managers"",""id"":""d7c46856-8a66-485a-9047-098eba08b9a3"",""isEnabled"":true,""origin"":""Application"",""value"":""managers""}]","{""logoUrl"":null,""marketingUrl"":null,""privacyStatementUrl"":null,""supportUrl"":null,""termsOfServiceUrl"":null}",[],"{""countriesBlockedForMinors"":[],""legalAgeGroupRule"":""Allow""}",[],"{""redirectUris"":[]}","[{""resourceAppId"":""b55b276d-2b09-4ad2-8de5-f09cf24ffba9"",""resourceAccess"":[{""id"":""162b1576-a2b2-458d-b7b9-04481911b4ef"",""type"":""Role""}]},{""resourceAppId"":""00000005-0000-0ff1-ce00-000000000000"",""resourceAccess"":[{""id"":""8e5870bb-8808-44dc-8e10-c509ed919ddd"",""type"":""Scope""},{""id"":""5db81a03-0de0-432b-b31e-71d57c8d2e0b"",""type"":""Scope""}]}]","{""displayName"":null,""verifiedPublisherId"":null,""addedDateTime"":null}","{""homePageUrl"":null,""logoutUrl"":null,""redirectUris"":[],""implicitGrantSettings"":{""enableAccessTokenIssuance"":false,""enableIdTokenIssuance"":false},""redirectUriSettings"":[]}","{""redirectUris"":[]}"
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # app get --appId "02f9ff8c-b79e-4552-bdda-4facd74d6df1"
+
+  Date: 5/29/2023
+
+  ## My AAD app (b3241f2a-6551-43d4-a72f-0d02ccfeb77f)
+
+  Property | Value
+  ---------|-------
+  id | b3241f2a-6551-43d4-a72f-0d02ccfeb77f
+  appId | 02f9ff8c-b79e-4552-bdda-4facd74d6df1
+  createdDateTime | 2022-10-28T21:20:57Z
+  displayName | My AAD app
+  publisherDomain | contoso.onmicrosoft.com
+  signInAudience | AzureADMyOrg
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/app/app-open.mdx

@@ -0,0 +1,85 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# app open
+
+Returns deep link of the current AD app to open the Azure portal on the Azure AD app registration management page.
+
+## Usage
+
+```sh
+m365 app open [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Optional Application (client) ID of the Azure AD application registration to open. Uses the app from the `.m365rc.json` file corresponding to the `appId`. If multiple apps are available, this will evade the prompt to choose an app. If the `appId` is not available in the list of apps, an error is thrown.
+
+`--preview`
+: Use to open the url of the Azure AD preview portal.
+```
+
+<Global />
+
+## Remarks
+
+If config setting `autoOpenLinksInBrowser` is configured to true, the command will automatically open the link to the Azure Portal in the browser.
+
+Gets the app from the `.m365rc.json` file in the current directory. If the `--appId` option is not used and multiple apps are available, it will prompt the user to choose one.
+
+## Examples
+
+Prints the URL to the Azure AD application registration management page on the Azure Portal. 
+
+```sh
+m365 app open
+```
+
+Prints the url of the Azure AD application registration management page on the preview Azure Portal.
+
+```sh
+m365 app open --preview
+```
+
+Prints the URL to the Azure AD application registration management page on the Azure Portal, evading a possible choice prompt in the case of multiple saved apps in the `.m365rc.json` file. 
+
+```sh
+m365 app open --appId d75be2e1-0204-4f95-857d-51a37cf40be8 
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  "Use a web browser to open the page https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Overview/appId/02f9ff8c-b79e-4552-bdda-4facd74d6df2/isMSAApp/"
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  Use a web browser to open the page https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Overview/appId/02f9ff8c-b79e-4552-bdda-4facd74d6df2/isMSAApp/
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  Use a web browser to open the page https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Overview/appId/02f9ff8c-b79e-4552-bdda-4facd74d6df2/isMSAApp/
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  Use a web browser to open the page https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Overview/appId/02f9ff8c-b79e-4552-bdda-4facd74d6df2/isMSAApp/
+  ```
+
+  </TabItem>
+</Tabs>
+

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

@@ -0,0 +1,57 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# app permission add
+
+Adds the specified application and/or delegated permissions to the current AAD app API permissions
+
+## Usage
+
+```sh
+m365 app permission add [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve API permissions for.
+
+`--applicationPermission [applicationPermission]`
+: Space-separated list of application permissions to add.
+
+`--delegatedPermission [delegatedPermission]`
+: Space-separated list of delegated permissions to add.
+
+`--grantAdminConsent`
+: If specified, admin consent to the newly added permissions will be granted.
+```
+
+<Global />
+
+## Remarks
+
+If you have multiple apps registered in your .m365rc.json file, you can specify the app for which you'd like to retrieve permissions using the `--appId` option. If you don't specify the app using the `--appId` option, you'll be prompted to select one of the applications from your .m365rc.json file.
+
+## Examples
+
+Adds the specified application permissions to the default app registered in the _.m365rc.json_ file while granting admin consent.
+
+```sh
+m365 app permission add --applicationPermission 'https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/User.Read.All' --grantAdminConsent
+```
+
+Adds the specified delegated permissions to the default app registered in the _.m365rc.json_ file without granting admin consent.
+
+```sh
+m365 app permission add --delegatedPermission 'https://graph.microsoft.com/offline_access'
+```
+
+Adds the specified application and delegated permissions to a specific app registered in the _.m365rc.json_ file while granting admin consent.
+
+```sh
+m365 app permission add --appId '1663767b-4172-4519-bfd1-28e6ff19055b' --applicationPermission 'https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/User.Read.All' --delegatedPermission 'https://graph.microsoft.com/offline_access' --grantAdminConsent
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,93 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# app permission list
+
+Lists API permissions for the current AAD app
+
+## Usage
+
+```sh
+m365 app permission list [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve API permissions for.
+```
+
+<Global />
+
+## Remarks
+
+Use this command to quickly look up API permissions for the Azure AD application registration registered in the _.m365rc.json_ file in your current project (folder).
+
+If you have multiple apps registered in your .m365rc.json file, you can specify the app for which you'd like to retrieve permissions using the `--appId` option. If you don't specify the app using the `--appId` option, you'll be prompted to select one of the applications from your _.m365rc.json_ file.
+
+## Examples
+
+Retrieve API permissions for your current Azure AD app.
+
+```sh
+m365 app permission list
+```
+
+Retrieve API permissions for the Azure AD app with the client ID specified in the _.m365rc.json_ file.
+
+```sh
+m365 app permission list --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "resource": "Microsoft Teams - Teams And Channels Service",
+      "permission": "channels.readwrite",
+      "type": "Application"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  resource                                      permission          type
+  --------------------------------------------  ------------------  -----------
+  Microsoft Teams - Teams And Channels Service  channels.readwrite  Application
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  resource,permission,type
+  Microsoft Teams - Teams And Channels Service,channels.readwrite,Application
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # app permission list
+
+  Date: 5/29/2023
+
+  Property | Value
+  ---------|-------
+  resource | Microsoft Teams - Teams And Channels Service
+  permission | channels.readwrite
+  type | Application
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/booking/business/business-get.mdx

@@ -0,0 +1,176 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# booking business get
+
+Retrieve the specified Microsoft Bookings business.
+
+## Usage
+
+```sh
+m365 booking business get [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: ID of the business. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: Name of the business. Specify either `id` or `name` but not both.
+```
+
+<Global />
+
+## Examples
+
+Retrieve the specified Microsoft Bookings business with the specified id.
+
+```sh
+m365 booking business get --id 'business@contoso.onmicrosoft.com'
+```
+
+Retrieve the specified Microsoft Bookings business with the specified name.
+
+```sh
+m365 booking business get --name 'business name'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "Accounting@contoso.onmicrosoft.com",
+    "displayName": "Accounting",
+    "businessType": "Financial services",
+    "phone": "",
+    "email": "runningdevadmin@contoso.onmicrosoft.com",
+    "webSiteUrl": "",
+    "defaultCurrencyIso": "USD",
+    "isPublished": true,
+    "publicUrl": "https://outlook.office365.com/owa/calendar/Accounting@contoso.onmicrosoft.com/bookings/",
+    "languageTag": "",
+    "address": {
+      "street": "",
+      "city": "",
+      "state": "",
+      "countryOrRegion": "",
+      "postalCode": ""
+    },
+    "businessHours": [
+      {
+        "day": "monday",
+        "timeSlots": [
+          {
+            "startTime": "08:00:00.0000000",
+            "endTime": "17:00:00.0000000"
+          }
+        ]
+      },
+      {
+        "day": "tuesday",
+        "timeSlots": [
+          {
+            "startTime": "08:00:00.0000000",
+            "endTime": "17:00:00.0000000"
+          }
+        ]
+      },
+      {
+        "day": "wednesday",
+        "timeSlots": [
+          {
+            "startTime": "08:00:00.0000000",
+            "endTime": "17:00:00.0000000"
+          }
+        ]
+      },
+      {
+        "day": "thursday",
+        "timeSlots": [
+          {
+            "startTime": "08:00:00.0000000",
+            "endTime": "17:00:00.0000000"
+          }
+        ]
+      },
+      {
+        "day": "friday",
+        "timeSlots": [
+          {
+            "startTime": "08:00:00.0000000",
+            "endTime": "17:00:00.0000000"
+          }
+        ]
+      },
+      {
+        "day": "saturday",
+        "timeSlots": []
+      },
+      {
+        "day": "sunday",
+        "timeSlots": []
+      }
+    ],
+    "schedulingPolicy": {
+      "timeSlotInterval": "PT30M",
+      "minimumLeadTime": "P1D",
+      "maximumAdvance": "P365D",
+      "sendConfirmationsToOwner": true,
+      "allowStaffSelection": true
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  businessType      : Financial services
+  defaultCurrencyIso: USD
+  displayName       : Accounting
+  email             : runningdevadmin@contoso.onmicrosoft.com
+  id                : Accounting@contoso.onmicrosoft.com
+  phone             :
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,displayName,businessType,phone,email,defaultCurrencyIso
+  Accounting@contoso.onmicrosoft.com,Accounting,Financial services,,runningdevadmin@contoso.onmicrosoft.com,USD
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # booking business get --name "Accounting"
+
+  Date: 5/29/2023
+
+  ## Accounting (Accounting@contoso.onmicrosoft.com)
+
+  Property | Value
+  ---------|-------
+  id | Accounting@contoso.onmicrosoft.com
+  displayName | Accounting
+  businessType | Financial services
+  phone |
+  email | runningdevadmin@contoso.onmicrosoft.com
+  webSiteUrl |
+  defaultCurrencyIso | USD
+  isPublished | true
+  publicUrl | https://outlook.office365.com/owa/calendar/Accounting@contoso.onmicrosoft.com/bookings/
+  languageTag |
+  ```
+  
+  </TabItem>
+</Tabs>
+