@pnp/cli-microsoft365 7.7.0-beta.a12fb3e → 7.7.0-beta.cec4ca2

package/dist/utils/spo.js

@@ -1,3 +1,4 @@
+import os from 'os';
 import url from 'url';
 import { urlUtil } from "./urlUtil.js";
 import { validation } from "./validation.js";
@@ -1231,6 +1232,113 @@ export const spo = {
         };
         await request.post(requestOptions);
     },
+    /**
+    * Gets a file as list item by url
+    * @param absoluteListUrl The absolute url to the list
+    * @param url The url of the file
+    * @param logger The logger object
+    * @param verbose If in verbose mode
+    * @returns The list item object
+    */
+    async getFileAsListItemByUrl(absoluteListUrl, url, logger, verbose) {
+        if (verbose && logger) {
+            logger.logToStderr(`Getting the file properties with url ${url}`);
+        }
+        const serverRelativePath = urlUtil.getServerRelativePath(absoluteListUrl, url);
+        const requestUrl = `${absoluteListUrl}/_api/web/GetFileByServerRelativePath(DecodedUrl=@f)?$expand=ListItemAllFields&@f='${formatting.encodeQueryParameter(serverRelativePath)}'`;
+        const requestOptions = {
+            url: requestUrl,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const file = await request.get(requestOptions);
+        return file.ListItemAllFields;
+    },
+    /**
+    * Updates a list item with system update
+    * @param absoluteListUrl The absolute base URL without query parameters, pointing to the specific list where the item resides. This URL should represent the list.
+    * @param itemId The id of the list item
+    * @param properties An object of the properties that should be updated
+    * @param contentTypeName The name of the content type to update
+    * @param logger The logger object
+    * @param verbose If in verbose mode
+    * @returns The updated list item object
+    */
+    async systemUpdateListItem(absoluteListUrl, itemId, logger, verbose, properties, contentTypeName) {
+        if (!properties && !contentTypeName) {
+            // Neither properties nor contentTypeName provided, no need to proceed
+            throw 'Either properties or contentTypeName must be provided for systemUpdateListItem.';
+        }
+        const parsedUrl = new URL(absoluteListUrl);
+        const serverRelativeSiteMatch = absoluteListUrl.match(new RegExp('/sites/[^/]+'));
+        const webUrl = `${parsedUrl.protocol}//${parsedUrl.host}${serverRelativeSiteMatch ?? ''}`;
+        if (verbose && logger) {
+            logger.logToStderr(`Getting list id...`);
+        }
+        const listRequestOptions = {
+            url: `${absoluteListUrl}?$select=Id`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const list = await request.get(listRequestOptions);
+        const listId = list.Id;
+        if (verbose && logger) {
+            logger.logToStderr(`Getting request digest for systemUpdate request`);
+        }
+        const res = await spo.getRequestDigest(webUrl);
+        const formDigestValue = res.FormDigestValue;
+        const objectIdentity = await spo.requestObjectIdentity(webUrl, logger, verbose);
+        let index = 0;
+        const requestBodyOptions = properties ? Object.keys(properties).map(key => `
+    <Method Name="ParseAndSetFieldValue" Id="${++index}" ObjectPathId="147">
+      <Parameters>
+        <Parameter Type="String">${key}</Parameter>
+        <Parameter Type="String">${properties[key].toString()}</Parameter>
+      </Parameters>
+    </Method>`) : [];
+        const additionalContentType = contentTypeName ? `
+    <Method Name="ParseAndSetFieldValue" Id="${++index}" ObjectPathId="147">
+      <Parameters>
+        <Parameter Type="String">ContentType</Parameter>
+        <Parameter Type="String">${contentTypeName}</Parameter>
+      </Parameters>
+    </Method>` : '';
+        const requestBody = `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009">
+      <Actions>
+        ${requestBodyOptions.join('')}${additionalContentType}
+        <Method Name="SystemUpdate" Id="${++index}" ObjectPathId="147" />
+      </Actions>
+      <ObjectPaths>
+        <Identity Id="147" Name="${objectIdentity}:list:${listId}:item:${itemId},1" />
+      </ObjectPaths>
+    </Request>`;
+        const requestOptions = {
+            url: `${webUrl}/_vti_bin/client.svc/ProcessQuery`,
+            headers: {
+                'Content-Type': 'text/xml',
+                'X-RequestDigest': formDigestValue
+            },
+            data: requestBody
+        };
+        const response = await request.post(requestOptions);
+        if (response.indexOf("ErrorMessage") > -1) {
+            throw `Error occurred in systemUpdate operation - ${response}`;
+        }
+        const id = Number(itemId);
+        const requestOptionsItems = {
+            url: `${absoluteListUrl}/items(${id})`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const itemsResponse = await request.get(requestOptionsItems);
+        return (itemsResponse);
+    },
     /**
      * Removes the retention label from the items in the given list.
      * @param webUrl The url of the web
@@ -1334,6 +1442,86 @@ export const spo = {
         };
         const site = await request.get(requestOptions);
         return site.id;
+    },
+    /**
+     * Retrieves the ObjectIdentity from a SharePoint site
+     * @param webUrl web url
+     * @param logger The logger object
+     * @param verbose If in verbose mode
+     * @return The ObjectIdentity as string
+     */
+    async requestObjectIdentity(webUrl, logger, verbose) {
+        const res = await spo.getRequestDigest(webUrl);
+        const formDigestValue = res.FormDigestValue;
+        const requestOptions = {
+            url: `${webUrl}/_vti_bin/client.svc/ProcessQuery`,
+            headers: {
+                'X-RequestDigest': formDigestValue
+            },
+            data: `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><Query Id="1" ObjectPathId="5"><Query SelectAllProperties="false"><Properties><Property Name="ServerRelativeUrl" ScalarProperty="true" /></Properties></Query></Query></Actions><ObjectPaths><Property Id="5" ParentId="3" Name="Web" /><StaticProperty Id="3" TypeId="{3747adcd-a3c3-41b9-bfab-4a64dd2f1e0a}" Name="Current" /></ObjectPaths></Request>`
+        };
+        const response = await request.post(requestOptions);
+        if (verbose) {
+            logger.logToStderr('Attempt to get _ObjectIdentity_ key values');
+        }
+        const json = JSON.parse(response);
+        const contents = json.find(x => { return x.ErrorInfo; });
+        if (contents && contents.ErrorInfo) {
+            throw contents.ErrorInfo.ErrorMessage || 'ClientSvc unknown error';
+        }
+        const identityObject = json.find(x => { return x._ObjectIdentity_; });
+        if (identityObject) {
+            return identityObject._ObjectIdentity_;
+        }
+        throw 'Cannot proceed. _ObjectIdentity_ not found'; // this is not supposed to happen
+    },
+    /**
+    * Updates a list item without system update
+    * @param absoluteListUrl The absolute base URL without query parameters, pointing to the specific list where the item resides. This URL should represent the list.
+    * @param itemId The id of the list item
+    * @param properties An object of the properties that should be updated
+    * @param contentTypeName The name of the content type to update
+    * @returns The updated listitem object
+    */
+    async updateListItem(absoluteListUrl, itemId, properties, contentTypeName) {
+        const requestBodyOptions = [
+            ...(properties
+                ? Object.keys(properties).map((key) => ({
+                    FieldName: key,
+                    FieldValue: properties[key].toString()
+                }))
+                : [])
+        ];
+        const requestBody = {
+            formValues: requestBodyOptions
+        };
+        contentTypeName && requestBody.formValues.push({
+            FieldName: 'ContentType',
+            FieldValue: contentTypeName
+        });
+        const requestOptions = {
+            url: `${absoluteListUrl}/items(${itemId})/ValidateUpdateListItem()`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            data: requestBody,
+            responseType: 'json'
+        };
+        const response = await request.post(requestOptions);
+        // Response is from /ValidateUpdateListItem POST call, perform get on updated item to get all field values
+        const fieldValues = response.value;
+        if (fieldValues.some(f => f.HasException)) {
+            throw `Updating the items has failed with the following errors: ${os.EOL}${fieldValues.filter(f => f.HasException).map(f => { return `- ${f.FieldName} - ${f.ErrorMessage}`; }).join(os.EOL)}`;
+        }
+        const requestOptionsItems = {
+            url: `${absoluteListUrl}/items(${itemId})`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const itemsResponse = await request.get(requestOptionsItems);
+        return (itemsResponse);
     }
 };
 //# sourceMappingURL=spo.js.map

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

@@ -21,6 +21,9 @@ m365 aad user list [options]
 ## Options
 
 ```md definition-list
+`--type [type]`
+: Filter the results to only users of a given type: `Member` or `Guest`. By default, all users are listed.
+
 `-p, --properties [properties]`
 : Comma-separated list of properties to retrieve
 ```
@@ -29,7 +32,9 @@ m365 aad user list [options]
 
 ## Remarks
 
-Using the `--properties` option, you can specify a comma-separated list of user properties to retrieve from the Microsoft Graph. If you don't specify any properties, the command will retrieve user's display name and account name.
+Using the `--properties` option, you can specify a comma-separated list of user properties to retrieve from the Microsoft Graph. If you don't specify any properties, the command will retrieve user's display name, account name, id, and mail.
+
+When the `properties` option includes values with a `/`, for example: `manager/displayName`, an additional `$expand` query parameter will be included on `manager`.
 
 To filter the list of users, include additional options that match the user property that you want to filter with. For example `--displayName Patt` will return all users whose `displayName` starts with `Patt`. Multiple filters will be combined using the `and` operator.
 
@@ -37,30 +42,42 @@ Certain properties cannot be returned within a user collection. The following pr
 
 ## Examples
 
-List all users in the tenant
+List all users in the tenant.
 
 ```sh
 m365 entra user list
 ```
 
-List all users in the tenant. For each one return the display name and e-mail address
+List all guest users in the tenant.
+
+```sh
+m365 entra user list --type Guest
+```
+
+List all users in the tenant. For each one return the display name and e-mail address.
 
 ```sh
 m365 entra user list --properties "displayName,mail"
 ```
 
-Show users whose display name starts with _Patt_
+Show users whose display name starts with _Patt_.
 
 ```sh
 m365 entra user list --displayName Patt
 ```
 
-Show all account managers whose display name starts with _Patt_
+Show all account managers whose display name starts with _Patt_.
 
 ```sh
 m365 entra user list --displayName Patt --jobTitle 'Account manager'
 ```
 
+List users from the tenant. For each one return the display name, e-mail address, and manager information.
+
+```sh
+m365 entra user list --properties "displayName,mail,manager/*"
+```
+
 ## Response
 
 <Tabs>
@@ -69,8 +86,10 @@ m365 entra user list --displayName Patt --jobTitle 'Account manager'
   ```json
   [
     {
-      "userPrincipalName": "John@contoso.onmicrosoft.com",
-      "displayName": "John Doe"
+      "id": "1f5595b2-aa07-445d-9801-a45ea18160b2",
+      "displayName": "John Doe",
+      "mail": "John@contoso.onmicrosoft.com",
+      "userPrincipalName": "John@contoso.onmicrosoft.com"
     }
   ]
   ```
@@ -79,17 +98,17 @@ m365 entra user list --displayName Patt --jobTitle 'Account manager'
   <TabItem value="Text">
 
   ```text
-  userPrincipalName                         displayName
-  ----------------------------------------  -------------------------
-  John@contoso.onmicrosoft.com              John Doe
+  id                                    displayName         mail                                 userPrincipalName
+  ------------------------------------  ------------------  -----------------------------------  ------------------------------------------
+  1f5595b2-aa07-445d-9801-a45ea18160b2  John Doe            John@contoso.onmicrosoft.com         John@contoso.onmicrosoft.com
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  userPrincipalName,displayName
-  John@contoso.onmicrosoft.com,John Doe
+  id,displayName,mail,userPrincipalName
+  1f5595b2-aa07-445d-9801-a45ea18160b2,John Doe,John@contoso.onmicrosoft.com,John@contoso.onmicrosoft.com
   ```
 
   </TabItem>
@@ -100,12 +119,14 @@ m365 entra user list --displayName Patt --jobTitle 'Account manager'
 
   Date: 2023-06-02
 
-  ## John Doe
+  ## John Doe (1f5595b2-aa07-445d-9801-a45ea18160b2)
 
   Property | Value
   ---------|-------
-  userPrincipalName | John@contoso.onmicrosoft.com
+  id | 1f5595b2-aa07-445d-9801-a45ea18160b2
   displayName | John Doe
+  mail | John@contoso.onmicrosoft.com
+  userPrincipalName | John@contoso.onmicrosoft.com  
   ```
 
   </TabItem>
@@ -113,4 +134,4 @@ m365 entra user list --displayName Patt --jobTitle 'Account manager'
 
 ## More information
 
-- Microsoft Graph User properties: [https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties](https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties)
+- Microsoft Graph User properties: [https://learn.microsoft.com/graph/api/resources/user?view=graph-rest-1.0#properties](https://learn.microsoft.com/graph/api/resources/user?view=graph-rest-1.0#properties)

package/docs/docs/cmd/spe/containertype/containertype-add.mdx

@@ -0,0 +1,140 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spe containertype add
+
+Creates a new Container Type for your app
+
+## Usage
+
+```sh
+m365 spe containertype add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: Container type name.
+
+`--applicationId <applicationId>`
+: Application ID of the Microsoft Entra ID app that will be the owner of the Container Type.
+
+`--trial`
+: Specify if the Container Type should be a trial.
+
+`--azureSubscriptionId [azureSubscriptionId]`
+: Azure Subscription Id. Required unless the `trail` option was specified.
+
+`--resourceGroup [resourceGroup]`
+: Azure Resource group for billing. Required unless the `trail` option was specified.
+
+`--region [region]`
+: Region. Required unless the `trail` option was specified.
+```
+
+<Global />
+
+## Remarks
+
+:::note
+You can only create one Trial Container per tenant, a single application registration can only contain one Container and a tenant can contain a maximum of five Containers in total.
+:::
+
+## Examples
+
+Adds a new trial Container Type
+
+```sh
+m365 spe containertype add --name 'trial container' --applicationId '1b3b8660-9a44-4a7c-9c02-657f3ff5d5ac' --trial
+```
+
+Adds a new Container Type using a standard Container Type.
+
+```sh
+m365 spe containertype add --name 'standard container' --applicationId '1b3b8660-9a44-4a7c-9c02-657f3ff5d5ac' --azureSubscriptionId 'f08575e2-36c4-407f-a891-eabae23f66bc' --region 'West Europe' --resourceGroup 'Standard group'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "AzureSubscriptionId": "f08575e2-36c4-407f-a891-eabae23f66bc",
+    "ContainerTypeId": "c33cfee5-c9b6-0a2a-02ee-060693a57f37",
+    "CreationDate": "3/11/2024 2:38:56 PM",
+    "DisplayName": "standard container",
+    "ExpiryDate": null,
+    "IsBillingProfileRequired": true,
+    "OwningAppId": "1b3b8660-9a44-4a7c-9c02-657f3ff5d5ac",
+    "OwningTenantId": "e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
+    "Region": "West Europe",
+    "ResourceGroup": "Standard group",
+    "SPContainerTypeBillingClassification": "Standard"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  AzureSubscriptionId                 : f08575e2-36c4-407f-a891-eabae23f66bc
+  ContainerTypeId                     : 331f3b15-b4f6-05e0-05de-2d8c370462b3
+  CreationDate                        : 3/11/2024 2:47:16 PM
+  DisplayName                         : Standard container
+  ExpiryDate                          : null
+  IsBillingProfileRequired            : false
+  OwningAppId                         : 1b3b8660-9a44-4a7c-9c02-657f3ff5d5ac
+  OwningTenantId                      : e1dd4023-a656-480a-8a0e-c1b1eec51e1d
+  Region                              : West Europe
+  ResourceGroup                       : Standard group
+  SPContainerTypeBillingClassification: Standard
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  AzureSubscriptionId,ContainerTypeId,CreationDate,DisplayName,ExpiryDate,IsBillingProfileRequired,OwningAppId,OwningTenantId,Region,ResourceGroup,SPContainerTypeBillingClassification
+  f08575e2-36c4-407f-a891-eabae23f66bc,331f3b15-b4f6-05e0-05de-2d8c370462b3,3/11/2024 2:48:13 PM,Standard container,,,1b3b8660-9a44-4a7c-9c02-657f3ff5d5ac,e1dd4023-a656-480a-8a0e-c1b1eec51e1d,West Europe,Standard group,Standard
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spe containertype add --name 'Standard container' --applicationId '1b3b8660-9a44-4a7c-9c02-657f3ff5d5ac' --azureSubscriptionId 'f08575e2-36c4-407f-a891-eabae23f66bc' --region 'West Europe' --resourceGroup 'Standard group'
+
+  Date: 11/03/2024
+
+  ## Standard container
+
+  Property | Value
+  ---------|-------
+  AzureSubscriptionId | f08575e2-36c4-407f-a891-eabae23f66bc
+  ContainerTypeId | 331f3b15-b4f6-05e0-05de-2d8c370462b3
+  CreationDate | 3/11/2024 2:49:16 PM
+  DisplayName | Standard Container
+  IsBillingProfileRequired | false
+  OwningAppId | 1b3b8660-9a44-4a7c-9c02-657f3ff5d5ac
+  OwningTenantId | e1dd4023-a656-480a-8a0e-c1b1eec51e1d
+  Region | West Europe
+  ResourceGroup | Standard group
+  SPContainerTypeBillingClassification | Standard
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+In SharePoint Embedded, all files and documents are stored in Containers, and each Container is identified by a Container Type.
+
+Container Type is a property stamped on every Container instance. Each Container Type is owned by one Application, and each Application can own only one Container Type.
+
+The primary function of a Container Type is to manage the application workload that can access the Containers. Container Type defines the access permissions an Application has towards all Containers of that type, including create, read, write, delete containers; manage container permissions, etc.
+
+More information about SharePoint Embedded and the limits can be found at the following location: [SharePoint Embedded](https://learn.microsoft.com/en-us/sharepoint/dev/embedded/concepts/app-concepts/containertypes#sharepoint-embedded-trial-container-types)

package/docs/docs/cmd/spfx/project/project-upgrade.mdx

@@ -35,7 +35,7 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.18.2).
+The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.19.0-beta.0).
 
 This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
 

package/docs/docs/cmd/spfx/spfx-doctor.mdx

@@ -27,7 +27,7 @@ m365 spfx doctor [options]
 : JMESPath query string. See [http://jmespath.org/](http://jmespath.org/) for more information and examples
 
 `-o, --output [output]`
-: Output type. `text`. Default `text`
+: Output type. `text` or `json`. Default `text`
 
 `--verbose`
 : Runs command with verbose logging
@@ -56,7 +56,7 @@ Checks ran by this command are based on what is officially supported by Microsof
 
 :::info
 
-This command supports only text output.
+This command supports only text or json output.
 
 :::
 
@@ -80,11 +80,67 @@ Verify if your environment meets the requirements to work with SharePoint Framew
 m365 spfx doctor --spfxVersion 1.11.0 --output text
 ```
 
+Verify if your environment meets the requirements to work with SharePoint Framework v1.11.0 and outputs it in a JSON format.
+
+```sh
+m365 spfx doctor --spfxVersion 1.11.0 --output json
+```
+
 ## Response
 
 ### Response with no issues
 
 <Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "check": "SharePoint Framework",
+      "passed": true,
+      "version": "1.18.2",
+      "message": "SharePoint Framework v1.18.2 valid."
+    },
+    {
+      "check": "SharePoint Framework",
+      "passed": true,
+      "version": "1.18.2",
+      "message": "SharePoint Framework v1.18.2"
+    },
+    {
+      "check": "env",
+      "passed": true,
+      "message": "Supported in SPO",
+      "version": "spo"
+    },
+    {
+      "check": "Node",
+      "passed": true,
+      "message": "Node v18.18.2",
+      "version": "18.18.2"
+    },
+    {
+      "check": "yo",
+      "passed": true,
+      "message": "yo v5.0.0",
+      "version": "5.0.0"
+    },
+    {
+      "check": "gulp-cli",
+      "passed": true,
+      "message": "gulp-cli v2.3.0",
+      "version": "2.3.0"
+    },
+    {
+      "check": "typescript",
+      "passed": true,
+      "message": "bundled typescript used"
+    }
+  ]
+  ```
+
+  </TabItem>
+
   <TabItem value="Text">
 
   ```text
@@ -106,6 +162,56 @@ m365 spfx doctor --spfxVersion 1.11.0 --output text
 When the installed version of Yeoman is lower than expected to run SharePoint Framework v1.15.0
 
 <Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "check": "SharePoint Framework",
+      "passed": true,
+      "version": "1.15.0",
+      "message": "SharePoint Framework v1.15.0 valid."
+    },
+    {
+      "check": "SharePoint Framework",
+      "passed": true,
+      "version": "1.15.0",
+      "message": "SharePoint Framework v1.15.0"
+    },
+    {
+      "check": "env",
+      "passed": true,
+      "message": "Supported in SPO",
+      "version": "spo"
+    },
+    {
+      "check": "Node",
+      "passed": true,
+      "message": "Node v16.18.0",
+      "version": "16.18.0"
+    },
+    {
+      "check": "yo",
+      "passed": false,
+      "message": "yo v3.1.1 found, v^4 required",
+      "version": "3.1.1",
+      "fix": "npm i -g yo@4"
+    },
+    {
+      "check": "gulp-cli",
+      "passed": true,
+      "message": "gulp-cli v2.3.0",
+      "version": "2.3.0"
+    },
+    {
+      "check": "typescript",
+      "passed": true,
+      "message": "bundled typescript used"
+    }
+  ]
+  ```
+
+  </TabItem>
   <TabItem value="Text">
 
   ```text

package/docs/docs/cmd/spo/page/page-set.mdx

@@ -44,7 +44,7 @@ m365 spo page set [options]
 : The title to set for the page.
 
 `--content [content]`
-: JSON string containing page content
+: JSON string containing page content.
 ```
 
 <Global />

package/docs/docs/cmd/spo/site/site-apppermission-add.mdx

@@ -32,7 +32,7 @@ m365 spo site apppermission add [options]
 
 ## Remarks
 
-To set permissions, specify at minimum either `appId` or `addDisplayName`. For best performance specify both values to avoid extra lookup.
+To set permissions, specify at minimum either `appId` or `appDisplayName`. For best performance specify both values to avoid extra lookup.
 
 ## Example