@pnp/cli-microsoft365 6.9.0-beta.289ab69 → 6.9.0-beta.bb31388

package/docs/docs/cmd/yammer/user/user-list.mdx

@@ -0,0 +1,228 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# yammer user list
+
+Returns users from the current network
+
+## Usage
+
+```sh
+m365 yammer user list [options]
+```
+
+## Options
+
+```md defintion-list
+`-g, --groupId [groupId]`
+: Returns users within a given group
+
+`-l, --letter [letter]`
+: Returns users with usernames beginning with the given character
+
+`--reverse`
+: Returns users in reverse sorting order
+
+`--limit [limit]`
+: Limits the users returned
+
+`--sortBy [sortBy]`
+: Returns users sorted by a number of messages or followers, instead of the default behavior of sorting alphabetically. Allowed values are `messages,followers`
+```
+
+<Global />
+
+## Remarks
+
+:::caution
+
+In order to use this command, you need to grant the Azure AD application used by the CLI for Microsoft 365 the permission to the Yammer API. To do this, execute the `cli consent --service yammer` command.
+
+:::
+
+## Examples
+  
+Returns all Yammer network users
+
+```sh
+m365 yammer user list
+```
+
+Returns all Yammer network users with usernames beginning with "a"
+
+```sh
+m365 yammer user list --letter a
+```
+
+Returns all Yammer network users sorted alphabetically in descending order
+
+```sh
+m365 yammer user list --reverse
+```
+
+Returns the first 10 Yammer network users within the group 5785177
+
+```sh
+m365 user list --groupId 5785177 --limit 10
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "type": "user",
+      "id": 172006440961,
+      "network_id": 5897756673,
+      "state": "active",
+      "job_title": "",
+      "location": null,
+      "interests": null,
+      "summary": null,
+      "expertise": null,
+      "full_name": "John Doe",
+      "activated_at": "2021/10/08 11:45:32 +0000",
+      "auto_activated": false,
+      "show_ask_for_photo": true,
+      "first_name": "",
+      "last_name": "",
+      "network_name": "Contoso",
+      "network_domains": [
+        "contoso.onmicrosoft.com"
+      ],
+      "url": "https://www.yammer.com/api/v1/users/172006440961",
+      "web_url": "https://www.yammer.com/contoso.onmicrosoft.com/users/172006440961",
+      "name": "johndoe",
+      "mugshot_url": "https://mugshot0eu-1.assets-yammer.com/mugshot/images/no_photo.png?P1=1668205841&P2=104&P3=1&P4=rnM2FPGOQRZja018qxAFshyyDKKH5SoUXkdpCeizRsdD7Ggb9sLSsdEaq-icgk8g-QTHFd0Te4e1gWAZTGEQekSQop6G6zDcipIVbZMJStEzfKKUpSPckcXnRhfiI55yq5AOLhVcH2PP_ZBFF-0KXMaP8Hy4dGDIRzmnUGhFuik0yjNBoGaYL86ltEaDMQdpS6rS3lmIMzLPGEMfr30vethAxRT7SKBbNYxZ9iPxO6TY26cYCfv0VyyMQkGGviPU4__EVjOoklhD_AqFGFGHtRTcsafpKOxCE70Z-nUpIPbYCel3las7w105u4SvPPC00Q5LUMDynUvzPiR4-vbWPg&size=48x48",
+      "mugshot_redirect_url": "https://www.yammer.com/mugshot/images/redirect/48x48/no_photo.png",
+      "mugshot_url_template": "https://mugshot0eu-1.assets-yammer.com/mugshot/images/no_photo.png?P1=1668205841&P2=104&P3=1&P4=rnM2FPGOQRZja018qxAFshyyDKKH5SoUXkdpCeizRsdD7Ggb9sLSsdEaq-icgk8g-QTHFd0Te4e1gWAZTGEQekSQop6G6zDcipIVbZMJStEzfKKUpSPckcXnRhfiI55yq5AOLhVcH2PP_ZBFF-0KXMaP8Hy4dGDIRzmnUGhFuik0yjNBoGaYL86ltEaDMQdpS6rS3lmIMzLPGEMfr30vethAxRT7SKBbNYxZ9iPxO6TY26cYCfv0VyyMQkGGviPU4__EVjOoklhD_AqFGFGHtRTcsafpKOxCE70Z-nUpIPbYCel3las7w105u4SvPPC00Q5LUMDynUvzPiR4-vbWPg&size={width}x{height}",
+      "mugshot_redirect_url_template": "https://www.yammer.com/mugshot/images/redirect/{width}x{height}/no_photo.png",
+      "birth_date": "",
+      "birth_date_complete": "",
+      "timezone": "Pacific Time (US & Canada)",
+      "external_urls": [],
+      "admin": "true",
+      "verified_admin": "true",
+      "m365_yammer_admin": "false",
+      "supervisor_admin": "false",
+      "o365_tenant_admin": "true",
+      "can_broadcast": "true",
+      "department": null,
+      "email": "johndoe@contoso.onmicrosoft.com",
+      "guest": false,
+      "aad_guest": false,
+      "can_view_delegations": false,
+      "can_create_new_network": false,
+      "can_browse_external_networks": false,
+      "reaction_accent_color": "none",
+      "significant_other": "",
+      "kids_names": "",
+      "previous_companies": [],
+      "schools": [],
+      "contact": {
+        "im": {
+          "provider": "",
+          "username": ""
+        },
+        "phone_numbers": [],
+        "email_addresses": [
+          {
+            "type": "primary",
+            "address": "johndoe@contoso.onmicrosoft.com"
+          }
+        ],
+        "has_fake_email": false
+      },
+      "stats": {
+        "updates": 0,
+        "following": 0,
+        "followers": 0
+      },
+      "settings": {
+        "xdr_proxy": ""
+      },
+      "show_invite_lightbox": false
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id            full_name         email
+  ------------  ----------------  -------------------------------
+  36425097217   John Doe          johndoe@contoso.onmicrosoft.com
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,full_name,email
+  36425097217,John Doe,johndoe@contoso.onmicrosoft.com
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # yammer user list --limit "1"
+
+  Date: 2023-05-16
+
+  ## john (172006440961)
+
+  Property | Value
+  ---------|-------
+  type | user
+  id | 172006440961
+  network\_id | 98327945216
+  state | active
+  job\_title | Retail Manager
+  location | 18/2111
+  summary |
+  full\_name | john doe
+  activated\_at | 2022/12/12 12:49:34 +0000
+  auto\_activated | false
+  show\_ask\_for\_photo | false
+  first\_name | john
+  last\_name | doe
+  network\_name | Contoso
+  url | https://www.yammer.com/api/v1/users/172006440961
+  web\_url | https://www.yammer.com/contoso.onmicrosoft.com/users/172006440961
+  name | john
+  mugshot\_url | https://mugshot0.assets-yammer.com/mugshot/images/jm2p4dHNWgVr1Q1C5jbGvcmWqVM5W9Zj?P1=1684269325&P2=104&P3=1&P4=I\_DbxkwAcCq1cmFgxWINlSF3VQH9EqvZBvoYtO\_XqC4T0mboYO6i381CGmffkQvNAbhjlAn1u9uFg-9mnK0alNJI3DzstJNRSEvFEi-iu0TPnWM7obmcD6tLr5xPNnkhn0jVIcVCF\_l0MyMUGAL2tcSHRy\_j0IvfrP3i4jkColZbiYmng\_4QseJC5y1G9fFn7mpPt2LN7-Qew\_ybxWJXEh6ABLAoCm9\_PmV7TuUt4M\_s-pKDZkQA6\_CDgRLdcHzV2MgZVX0MhkYLnsonoqFiQfns9qmeMPrKAUawQKuupxEI9QHG\_4\_T\_Ncp5OfYXGQXmZt3L5OhAlk2SpoYhdBYtQ&size=48x48
+  mugshot\_redirect\_url | https://www.yammer.com/mugshot/images/redirect/48x48/jm2p4dHNWgVr1Q1C5jbGvcmWqVM5W9Zj
+  mugshot\_url\_template | https://mugshot0.assets-yammer.com/mugshot/images/jm2p4dHNWgVr1Q1C5jbGvcmWqVM5W9Zj?P1=1684269325&P2=104&P3=1&P4=I\_DbxkwAcCq1cmFgxWINlSF3VQH9EqvZBvoYtO\_XqC4T0mboYO6i381CGmffkQvNAbhjlAn1u9uFg-9mnK0alNJI3DzstJNRSEvFEi-iu0TPnWM7obmcD6tLr5xPNnkhn0jVIcVCF\_l0MyMUGAL2tcSHRy\_j0IvfrP3i4jkColZbiYmng\_4QseJC5y1G9fFn7mpPt2LN7-Qew\_ybxWJXEh6ABLAoCm9\_PmV7TuUt4M\_s-pKDZkQA6\_CDgRLdcHzV2MgZVX0MhkYLnsonoqFiQfns9qmeMPrKAUawQKuupxEI9QHG\_4\_T\_Ncp5OfYXGQXmZt3L5OhAlk2SpoYhdBYtQ&size={width}x{height}
+  mugshot\_redirect\_url\_template | https://www.yammer.com/mugshot/images/redirect/{width}x{height}/jm2p4dHNWgVr1Q1C5jbGvcmWqVM5W9Zj
+  birth\_date |
+  birth\_date\_complete |
+  timezone | Pacific Time (US & Canada)
+  admin | false
+  verified\_admin | false
+  m365\_yammer\_admin | false
+  supervisor\_admin | false
+  o365\_tenant\_admin | false
+  answers\_admin | false
+  corporate\_communicator | false
+  can\_broadcast | false
+  email | johndoe@contoso.onmicrosoft.com
+  guest | false
+  aad\_guest | false
+  can\_view\_delegations | false
+  can\_create\_new\_network | true
+  can\_browse\_external\_networks | true
+  reaction\_accent\_color | none
+  significant\_other |
+  kids\_names |
+  show\_invite\_lightbox | false
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/yammer/yammer-search.mdx

@@ -0,0 +1,173 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# yammer search
+
+Returns a list of messages, users, topics and groups that match the specified query.
+
+## Usage
+
+```sh
+m365 yammer search [options]
+```
+
+## Options
+
+```md defintion-list
+`--queryText <queryText>`
+: The query for the search
+
+`--show [show]`
+: Specifies the type of data to return when using --output text. Allowed values `summary`, `messages`, `users`, `topics`, `groups`.
+
+`--limit [limit]`
+: Limits the results returned for each item category.
+```
+
+<Global />
+
+## Remarks
+
+:::caution
+
+In order to use this command, you need to grant the Azure AD application used by the CLI for Microsoft 365 the permission to the Yammer API. To do this, execute the `cli consent --service yammer` command.
+
+:::
+
+Using the `--show` option in JSON output is not supported. To filter JSON results, use either a JMESPath query or filter the data yourself after retrieving them.
+
+## Examples
+
+Returns search result for the query `community`
+
+```sh
+m365 yammer search --queryText "community"
+```
+
+Returns groups that match `community`
+
+```sh
+m365 yammer search --queryText "community" --show "groups"
+```
+
+Returns topics that match `community`
+
+```sh
+m365 yammer search --queryText "community" --show "topics"
+```
+
+Returns the first 50 users who match the search query `nuborocks.onmicrosoft.com`
+
+```sh
+m365 yammer search --queryText "nuborocks.onmicrosoft.com" --show "users" --limit 50
+```
+
+Returns all search results for the query `community`. Stops at 1000 results.
+
+```sh
+m365 yammer search --queryText "community" --output json
+```
+
+Returns the search results for the query `community` and limits the results to the first 50 entries for each result category.
+
+```sh
+m365 yammer search --queryText "community" --output json --limit 50
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "summary": {
+      "messages": 1,
+      "topics": 0,
+      "users": 0,
+      "groups": 0
+    },
+    "messages": [
+      {
+        "id": 2000337648877569,
+        "sender_id": 36425097217,
+        "delegate_id": null,
+        "replied_to_id": null,
+        "created_at": "2022/11/11 21:00:14 +0000",
+        "network_id": 5897756673,
+        "message_type": "update",
+        "sender_type": "user",
+        "url": "https://www.yammer.com/api/v1/messages/2000337648877569",
+        "web_url": "https://www.yammer.com/contoso.onmicrosoft.com/messages/2000337648877569",
+        "group_id": 31158067201,
+        "body": {
+          "parsed": "Hello everyone!",
+          "plain": "Hello everyone!",
+          "rich": "Hello everyone!"
+        },
+        "thread_id": 2000337648877569,
+        "client_type": "O365 Api Auth",
+        "client_url": "https://api.yammer.com",
+        "system_message": false,
+        "direct_message": false,
+        "chat_client_sequence": null,
+        "language": "no",
+        "notified_user_ids": [],
+        "privacy": "public",
+        "attachments": [],
+        "liked_by": {
+          "count": 1,
+          "names": [
+            {
+              "full_name": "johndoe",
+              "permalink": "JohnDoe",
+              "user_id": 36425097217,
+              "network_id": 5897756673
+            }
+          ]
+        },
+        "supplemental_reply": false,
+        "content_excerpt": "Hello everyone!",
+        "group_created_id": 31158067201
+      }
+    ],
+    "users": [],
+    "topics": [],
+    "groups": []
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  description: It was great to meet so many of you at last week's sales conference! I came away...
+  id         : 2044787632865280
+  type       : message
+  web_url    : https://www.yammer.com/m365x47213793.onmicrosoft.com/messages/2044787632865280
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,description,type,web_url
+  2000337648877569,Hello everyone!,message,https://www.yammer.com/contoso.onmicrosoft.com/messages/2000337648877569
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # yammer search --queryText "contoso.onmicrosoft.com" --show "users" --limit "1"
+
+  Date: 2023-05-16
+
+  Property | Value
+  ---------|-------
+  ```
+
+  </TabItem>
+</Tabs>
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "6.9.0-beta.289ab69",
+  "version": "6.9.0-beta.bb31388",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",

package/docs/docs/_clisettings.md

@@ -1,21 +0,0 @@
-## Available settings
-
-Following is the list of configuration settings available in CLI for Microsoft 365.
-
-Setting name|Definition|Default value
-------------|----------|-------------
-`autoOpenLinksInBrowser`|Automatically open the browser for all commands which return a url and expect the user to copy paste this to the browser. For example when logging in, using `m365 login` in device code mode.|`false`
-`copyDeviceCodeToClipboard`|Automatically copy the device code to the clipboard when running `m365 login` command in device code mode|`false`
-`csvEscape`|Single character used for escaping; only apply to characters matching the quote and the escape options|`"`
-`csvHeader`|Display the column names on the first line|`true`
-`csvQuote`|The quote characters surrounding a field. An empty quote value will preserve the original field, whether it contains quotation marks or not.|` `
-`csvQuoted`|Quote all the non-empty fields even if not required|`false`
-`csvQuotedEmpty`|Quote empty strings and overrides quoted_string on empty strings when defined|`false`
-`disableTelemetry`|Disables sending of telemetry data|`false`
-`errorOutput`|Defines if errors should be written to `stdout` or `stderr`|`stderr`
-`helpMode`|Defines what part of command's help to display. Allowed values are `options`, `examples`, `remarks`, `response`, `full`|`full`
-`output`|Defines the default output when issuing a command|`json`
-`printErrorsAsPlainText`|When output mode is set to `json`, print error messages as plain-text rather than JSON|`true`
-`prompt`|Prompts for missing values in required options|`false`
-`showHelpOnFailure`|Automatically display help when executing a command failed|`true`
-`showSpinner`|Display spinner when executing commands|`true`

package/docs/docs/cmd/_global.md

@@ -1,14 +0,0 @@
-`-h, --help [help]`
-: Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are `options`, `examples`, `remarks`, `response`, `full`. Default is `full`.
-
-`--query [query]`
-: JMESPath query string. See [http://jmespath.org/](http://jmespath.org/) for more information and examples
-
-`-o, --output [output]`
-: Output type. `json,text,csv,md`. Default `json`
-
-`--verbose`
-: Runs command with verbose logging
-
-`--debug`
-: Runs command with debug logging

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

@@ -1,180 +0,0 @@
-# aad app add
-
-Creates new Azure AD app registration
-
-## Usage
-
-```sh
-m365 aad app add [options]
-```
-
-## Options
-
-`-n, --name [name]`
-: Name of the app. Specify either `name` or `manifest` but not both.
-
-`--multitenant`
-: Specify, to make the app available to other tenants.
-
-`-r, --redirectUris [redirectUris]`
-: Comma-separated list of redirect URIs. Requires `platform` to be specified.
-
-`-p, --platform [platform]`
-: Platform for which the `redirectUris` should be configured. Allowed values `spa`, `web`, `publicClient`.
-
-`--implicitFlow`
-: Specify, to indicate that the authorization endpoint should return ID and access tokens.
-
-`-s, --withSecret`
-: When specified, will create a secret named `Default` and set it to expire 1 year in the future.
-
-`--apisDelegated [apisDelegated]`
-: Comma-separated list of delegated permissions to register with the app.
-
-`--apisApplication [apisApplication]`
-: Comma-separated list of application permissions to register with the app.
-
-`-u, --uri [uri]`
-: Application ID URI.
-
-`--scopeName [scopeName]`
-: Name of the scope to add. Requires `uri` to be specified.
-
-`--scopeConsentBy [scopeConsentBy]`
-: Specifies if the scope can be consented only by admins or by admins and users. Allowed values `admins`, `adminsAndUsers`. Default `admins`.
-
-`--scopeAdminConsentDisplayName [scopeAdminConsentDisplayName]`
-: Scope admin consent display name.
-
-`--scopeAdminConsentDescription [scopeAdminConsentDescription]`
-: Scope admin consent description.
-
-`--certificateFile [certificateFile]`
-: Path to the file with certificate public key. Specify either `certificateFile` or `certificateBase64Encoded`.
-
-`--certificateBase64Encoded [certificateBase64Encoded]`
-: Base64-encoded string with certificate public key. Specify either `certificateFile` or `certificateBase64Encoded`.
-
-`--certificateDisplayName [certificateDisplayName]`
-: Display name for the certificate. If not given, the displayName will be set to the certificate subject. When specified, also specify either `certificateFile` or `certificateBase64Encoded`.
-
-`--grantAdminConsent`
-: When specified, grants application & delegated permissions through admin consent.
-
-`--manifest [manifest]`
-: Azure AD app manifest as retrieved from the Azure Portal to create the app registration from. Specify either `name` or `manifest` but not both.
-
-`--save`
-: Use to store the information about the created app in a local file.
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-You can use this command to create a new Azure AD app registration either by specifying the different configuration settings through the corresponding options or by using the manifest.
-
-If you don't use the manifest, you must specify the name of the Azure AD app registration using the `name` option. If you use the manifest, you can skip the `name` option assuming the manifest contains the `displayName` property.
-
-You can also use the manifest to provision some of the configuration settings of your Azure AD app. All properties specified in the manifest are optional and will set if specified.
-
-If you specify the manifest along with some options, values specified in the options will override settings from the manifest. One exception is the name specified in the `name` option which will be overridden by the `displayName` property from the manifest if specified.
-
-The following properties specified in the manifest retrieved from Azure AD are not supported by this command:
-
-- accessTokenAcceptedVersion
-- disabledByMicrosoftStatus
-- errorUrl
-- oauth2RequirePostResponse
-- oauth2AllowUrlPathMatching
-- orgRestrictions
-- samlMetadataUrl
-
-When specifying the value for the `uri`, you can use the `_appId_` token, to include the ID of the newly generated Azure AD app registration in the Application ID URI, eg. URI `api://caf406b91cd4.ngrok.io/_appId_` will become `api://caf406b91cd4.ngrok.io/ab3bd119-faf7-4db5-ba99-eb7e748f778a` where the last portion is the app ID of the created Azure AD app registration.
-
-When using the `withSecret` option, this command will automatically generate a secret named `Default` and set it to expire 1 year in the future.
-
-After creating the Azure AD app registration, this command returns the app ID and object ID of the created app registration. If you used the `withSecret` option, it will also return the generated secret.
-
-If you want to store the information about the created Azure AD app registration, use the `--save` option. This is useful when you build solutions connected to Microsoft 365 and want to easily manage app registrations used with your solution. When you use the `--save` option, after you create the app registration, the command will write its ID and name to the `.m365rc.json` file in the current directory. If the file already exists, it will add the information about the to it, allowing you to track multiple apps. If the file doesn't exist, the command will create it.
-
-When specifying `--grantAdminConsent` option, a service principal will be created for the app registration.
-
-## Examples
-
-Create new Azure AD app registration with the specified name
-
-```sh
-m365 aad app add --name 'My AAD app'
-```
-
-Create new Azure AD app registration from the manifest retrieved from the Azure Portal stored in a local file named _manifest.json_
-
-```sh
-m365 aad app add --manifest @manifest.json
-```
-
-Create new multitenant Azure AD app registration
-
-```sh
-m365 aad app add --name 'My AAD app' --multitenant
-```
-
-Create new Azure AD app registration for a web app with the specified redirect URIs
-
-```sh
-m365 aad app add --name 'My AAD app' --redirectUris 'https://myapp.azurewebsites.net,http://localhost:4000' --platform web
-```
-
-Create new Azure AD app registration for a desktop app
-
-```sh
-m365 aad app add --name 'My AAD app' --redirectUris 'https://login.microsoftonline.com/common/oauth2/nativeclient' --platform publicClient
-```
-
-Create new Azure AD app registration with an auto-generated secret (secret returned in the command output)
-
-```sh
-m365 aad app add --name 'My AAD app' --withSecret
-```
-
-Create new Azure AD app registration for a daemon app with specified Microsoft Graph application permissions
-
-```sh
-m365 aad app add --name 'My AAD app' --withSecret --apisApplication 'https://graph.microsoft.com/Group.ReadWrite.All,https://graph.microsoft.com/Directory.Read.All'
-```
-
-Create new Azure AD app registration for a single-page app with specified Microsoft Graph delegated permissions
-
-```sh
-m365 aad app add --name 'My AAD app' --platform spa --redirectUris 'https://myspa.azurewebsites.net,http://localhost:8080' --apisDelegated 'https://graph.microsoft.com/Calendars.Read,https://graph.microsoft.com/Directory.Read.All' --implicitFlow
-```
-
-Create new Azure AD app registration with Application ID URI set to a fixed value
-
-```sh
-m365 aad app add --name 'My AAD app' --uri https://contoso.onmicrosoft.com/myapp
-```
-
-Create new Azure AD app registration with Application ID URI set to a value that contains the ID of the app registration, designated with the `_appId_` token and a custom API scope that can be consented by both admins and users
-
-```sh
-m365 aad app add --name 'My AAD app' --uri api://caf406b91cd4.ngrok.io/_appId_ --scopeName access_as_user --scopeAdminConsentDescription 'Access as a user' --scopeAdminConsentDisplayName 'Access as a user' --scopeConsentBy adminsAndUsers
-```
-
-Create new Azure AD app registration for a daemon app with specified Microsoft Graph application permissions, including admin consent
-
-```sh
- m365 aad app add --name 'My AAD app' --apisApplication 'https://graph.microsoft.com/Group.ReadWrite.All' --grantAdminConsent
-```
-
-Create new Azure AD app registration with the specified name. Store information about the created app registration in the _.m365rc.json_ file in the current directory.
-
-```sh
-m365 aad app add --name 'My AAD app' --save
-```
-
-Create new Azure AD app registration with a certificate
-
-```sh
-m365 aad app add --name 'My AAD app' --certificateDisplayName "Some certificate name" --certificateFile "c:\temp\some-certificate.cer"
-```

package/docs/docs/cmd/aad/app/app-get.md

@@ -1,59 +0,0 @@
-# aad app get
-
-Gets an Azure AD app registration
-
-## Usage
-
-```sh
-m365 aad app get [options]
-```
-
-## Options
-
-`--appId [appId]`
-: Application (client) ID of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
-
-`--objectId [objectId]`
-: Object ID of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
-
-`--name [name]`
-: Name of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
-
-`--save`
-: Use to store the information about the created app in a local file
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-For best performance use the `objectId` option to reference the Azure AD application registration to get. If you use `appId` or `name`, this command will first need to find the corresponding object ID for that application.
-
-If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
-
-If you want to store the information about the Azure AD app registration, use the `--save` option. This is useful when you build solutions connected to Microsoft 365 and want to easily manage app registrations used with your solution. When you use the `--save` option, after you get the app registration, the command will write its ID and name to the `.m365rc.json` file in the current directory. If the file already exists, it will add the information about the App registration to it if it's not already present, allowing you to track multiple apps. If the file doesn't exist, the command will create it.
-
-## Examples
-
-Get the Azure AD application registration by its app (client) ID
-
-```sh
-m365 aad app get --appId d75be2e1-0204-4f95-857d-51a37cf40be8
-```
-
-Get the Azure AD application registration by its object ID
-
-```sh
-m365 aad app get --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
-```
-
-Get the Azure AD application registration by its name
-
-```sh
-m365 aad app get --name "My app"
-```
-
-Get the Azure AD application registration by its name. Store information about the retrieved app registration in the _.m365rc.json_ file in the current directory.
-
-```sh
-m365 aad app get --name "My app" --save
-```