@pnp/cli-microsoft365 7.7.0-beta.72886a7 → 7.7.0-beta.a12fb3e

package/docs/docs/cmd/entra/app/app-set.mdx

@@ -49,6 +49,9 @@ m365 entra appregistration set [options]
 
 `--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`.
+
+`--allowPublicClientFlows [allowPublicClientFlows]`
+: Set to `true` or `false` to toggle the allow public client flows feature on the app registration.
 ```
 
 <Global />
@@ -99,6 +102,12 @@ Add a certificate to the app
 m365 entra app set --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --certificateDisplayName "Some certificate name" --certificateFile "c:\temp\some-certificate.cer"
 ```
 
+Enable the allow public client flows feature on the app registration
+
+```sh
+m365 entra app set --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --allowPublicClientFlows true
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/entra/pim/pim-role-assignment-add.mdx

@@ -0,0 +1,230 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra pim role assignment add
+
+Request activation of an Entra role assignment for a user or group.
+
+## Usage
+
+```sh
+m365 entra pim role assignment add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --roleDefinitionName [roleDefinitionName]`	
+: Name of the role definition that should be assigned. Specify either `roleDefinitionName` or `roleDefinitionId` but not both.
+
+`-i, --roleDefinitionId [roleDefinitionId]`	
+: Id of the role definition that is being assigned. Specify either `roleDefinitionName` or `roleDefinitionId` but not both.
+
+`--userId [userId]`	
+: Id of the user that will be granted the assignment. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, the current user will be used.
+
+`--userName [userName]`	
+: UPN of the user that will be granted the assignment. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, the current user will be used.
+
+`--groupId [groupId]`
+: Id of the group that will be granted the assignment. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, the current user will be used.
+
+`--groupName [groupName]`
+: Display name of the group that will be granted the assignment. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, the current user will be used.
+
+`--administrativeUnitId [administrativeUnitId]`
+: Id of the administrative unit representing the scope of the assignment. Specify either `administrativeUnitId` or `applicationId`. If not specified, default scope will be tenant-wide.
+
+`--applicationId [applicationId]`
+: Object Id of the application representing the scope of the assignment. Specify either `administrativeUnitId` or `applicationId`. If not specified, default scope will be tenant-wide.
+
+`-j, --justification [justification]`
+: An optional justification message.
+
+`-s, --startDateTime [startDateTime]`
+: When the assignment should start. If left out, the assignment will start from the current time.
+
+`-e, --endDateTime [endDateTime]`
+: When the assignment should end. Specify either `duration`, `endDateTime` or `noExpiration`.
+
+`-d, --duration [duration]`
+: How long the assignment should last. Write in ISO 8601 format for durations: PT3H for 3 hours. Specify either `duration`, `endDateTime` or `noExpiration`.
+
+`--noExpiration [noExpiration]`
+: If specified, the role assignment will never expire. Specify either `duration`, `endDateTime` or `noExpiration`.
+
+`--ticketNumber [ticketNumber]`
+: Optional ticket number value to communicate with the request.
+
+`--ticketSystem [ticketSystem]`
+: Optional ticket system to communicate with the request.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+When activating a role for other users, you must be **Privileged Role Administrator**.
+
+:::
+
+## Examples
+
+Request activation of the SharePoint Administrator Entra role assignment for the current user.
+
+```sh
+m365 entra pim role assignment add --roleDefinitionName 'SharePoint Administrator'
+```
+
+Request activation of an Entra role assignment for the current user.
+
+```sh
+m365 entra pim role assignment add --roleDefinitionId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690'
+```
+
+Request activation of an Entra role assignment for the current user with a justification and max duration of 4 hours.
+
+```sh
+m365 entra pim role assignment add --roleDefinitionId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --justification 'Need Global Admin to release application xyz to production' --duration 'PT4H'
+```
+
+Request activation of an Entra role assignment for a specified user with tenant scope.
+
+```sh
+m365 entra pim role assignment add --roleDefinitionId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --userId '3488d6b8-6b2e-41c3-9583-1991205323c2'
+```
+
+Request activation of the User Administrator Entra role assignment for a specified group with administrative unit scope.
+
+```sh
+m365 entra pim role assignment add --roleDefinitionName 'User Administrator' --groupId '3488d6b8-6b2e-41c3-9583-1991205323c2' --administrativeUnitId '03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7'
+```
+
+Request activation of the Application Administrator Entra role assignment for a specified group with scope to a specific application.
+
+```sh
+m365 entra pim role assignment add --roleDefinitionName 'Application Administrator' --groupName 'Applications admins' --applicationId '03c4c9dc-6f0c-4c4f-a4e6-0c9ed80f54c7'
+```
+
+Request activation of an Entra role assignment for a specific period of two days.
+
+```sh
+m365 entra pim role assignment add --roleDefinitionName 'Global Administrator' --userName 'admin-john@contoso.com' --startDateTime '2024-01-10T09:00:00Z' --endDateTime '2024-01-11T17:00:00Z'
+```
+
+Request activation of an Entra role assignment with no expiration.
+
+```sh
+m365 entra pim role assignment add --roleDefinitionName 'Global Administrator' --userName 'admin-john@contoso.com' --noExpiration
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "3f7d1bd6-a9a5-45bc-b831-00cfa3e3c649",
+    "status": "Provisioned",
+    "createdDateTime": "2024-02-12T13:54:21.3110096Z",
+    "completedDateTime": "2024-02-12T13:54:21.9847061Z",
+    "approvalId": null,
+    "customData": null,
+    "action": "adminAssign",
+    "principalId": "61b0c52f-a902-4769-9a09-c6628335b00a",
+    "roleDefinitionId": "f28a1f50-f6e7-4571-818b-6a12f2af6b6c",
+    "directoryScopeId": "/",
+    "appScopeId": null,
+    "isValidationOnly": false,
+    "targetScheduleId": "3f7d1bd6-a9a5-45bc-b831-00cfa3e3c649",
+    "justification": "Need SharePoint Administrator role",
+    "createdBy": {
+      "application": null,
+      "device": null,
+      "user": {
+        "displayName": null,
+        "id": "893f9116-e024-4bc6-8e98-54c245129485"
+      }
+    },
+    "scheduleInfo": {
+      "startDateTime": "2024-02-12T13:54:21.9847061Z",
+      "recurrence": null,
+      "expiration": {
+        "type": "noExpiration",
+        "endDateTime": null,
+        "duration": null
+      }
+    },
+    "ticketInfo": {
+      "ticketNumber": null,
+      "ticketSystem": null
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  action           : adminAssign
+  appScopeId       : null
+  approvalId       : null
+  completedDateTime: 2024-02-12T14:02:09.8938321Z
+  createdBy        : {"application":null,"device":null,"user":{"displayName":null,"id":"893f9116-e024-4bc6-8e98-54c245129485"}}
+  createdDateTime  : 2024-02-12T14:02:09.4658344Z
+  customData       : null
+  directoryScopeId : /
+  id               : c221e106-0711-470a-83cf-f8d7cbc51ecd
+  isValidationOnly : false
+  justification    : Need SharePoint Administrator role
+  principalId      : 61b0c52f-a902-4769-9a09-c6628335b00a
+  roleDefinitionId : f28a1f50-f6e7-4571-818b-6a12f2af6b6c
+  scheduleInfo     : {"startDateTime":"2024-02-12T14:02:09.8938321Z","recurrence":null,"expiration":{"type":"noExpiration","endDateTime":null,"duration":null}}
+  status           : Provisioned
+  targetScheduleId : c221e106-0711-470a-83cf-f8d7cbc51ecd
+  ticketInfo       : {"ticketNumber":null,"ticketSystem":null}
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,status,createdDateTime,completedDateTime,approvalId,customData,action,principalId,roleDefinitionId,directoryScopeId,appScopeId,isValidationOnly,targetScheduleId,justification
+  7d727f44-c2dd-459e-8665-99ce003d12a9,Provisioned,2024-02-12T14:08:54.881749Z,2024-02-12T14:08:55.2507639Z,,,adminAssign,61b0c52f-a902-4769-9a09-c6628335b00a,f28a1f50-f6e7-4571-818b-6a12f2af6b6c,/,,,7d727f44-c2dd-459e-8665-99ce003d12a9,Need SharePoint Administrator role
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra pim roleassignment add --roleDefinitionId "f28a1f50-f6e7-4571-818b-6a12f2af6b6c" --userId "61b0c52f-a902-4769-9a09-c6628335b00a" --justification "Need SharePoint Administrator role"
+
+  Date: 2/13/2024
+
+  ## 7622802f-648b-4dd9-820f-dccaf8bbbab5
+
+  Property | Value
+  ---------|-------
+  id | 7622802f-648b-4dd9-820f-dccaf8bbbab5
+  status | Provisioned
+  createdDateTime | 2024-02-13T18:34:13.5365923Z
+  completedDateTime | 2024-02-13T18:34:14.269623Z
+  action | adminAssign
+  principalId | 61b0c52f-a902-4769-9a09-c6628335b00a
+  roleDefinitionId | f28a1f50-f6e7-4571-818b-6a12f2af6b6c
+  directoryScopeId | /
+  isValidationOnly | false
+  targetScheduleId | 7622802f-648b-4dd9-820f-dccaf8bbbab5
+  justification | Need SharePoint Administrator role
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Role assignment request: https://learn.microsoft.com/graph/api/rbacapplication-post-roleassignmentschedulerequests

package/docs/docs/cmd/entra/pim/pim-role-assignment-list.mdx

@@ -0,0 +1,224 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra pim role assignment list
+
+Retrieves a list of Entra role assignments for a user or group.
+
+## Usage
+
+```sh
+m365 entra pim role assignment list [options]
+```
+
+## Options
+
+```md definition-list
+`--userId [userId]`
+: Id of the user to list role assignments for. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all assigned roles will be listed.
+
+`--userName [userName]`
+: UPN of the user to list role assignments for. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all assigned roles will be listed.
+
+`--groupId [groupId]`
+: Id of the group to list role assignments for. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all assigned roles will be listed.
+
+`--groupName [groupName]`
+: Display name of the group to list role assignments for. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all assigned roles will be listed.
+
+`-s, --startDateTime [startDateTime]`
+: An optional ISO 8601 formatted date filter to search from.
+
+`--includePrincipalDetails`
+: An optional flag to include details of the principals that were assigned a role
+```
+
+<Global />
+
+## Examples
+
+Get a list of Entra role assignments.
+
+```sh
+m365 entra pim role assignment list
+```
+
+Get a list of Entra role assignments for the current user.
+
+```sh
+m365 entra pim role assignment list --userId '@meID'
+```
+
+Get a list of Entra role assignments since the first of January 2024
+
+```sh
+m365 entra pim role assignment list --startDateTime 2024-01-01T00:00:00Z
+```
+
+Get a list of Entra role assignments with principal details.
+
+```sh
+m365 entra pim role assignment list --includePrincipalDetails
+```
+
+## Response
+
+### Standard response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2",
+      "principalId": "61b0c52f-a902-4769-9a09-c6628335b00a",
+      "roleDefinitionId": "fe930be7-5e62-47db-91af-98c3a49a38b1",
+      "directoryScopeId": "/administrativeUnits/1a89e663-efcc-4911-8df7-e954714005de",
+      "appScopeId": null,
+      "startDateTime": "2023-11-15T12:24:32.773Z",
+      "endDateTime": null,
+      "assignmentType": "Assigned",
+      "memberType": "Direct",
+      "roleAssignmentOriginId": "5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2",
+      "roleAssignmentScheduleId": "36bd668f-3a40-455f-a40a-64074fde4a18",
+      "roleDefinition": {
+        "displayName": "User Administrator"
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                                                  principalId                           roleDefinitionId                      directoryScopeId                                           appScopeId  startDateTime             endDateTime  assignmentType  memberType  roleAssignmentOriginId                                              roleAssignmentScheduleId                                            roleDefinition
+  ------------------------------------------------------------------  ------------------------------------  ------------------------------------  ---------------------------------------------------------  ----------  ------------------------  -----------  --------------  ----------  ------------------------------------------------------------------  ------------------------------------------------------------------  ---------------
+  5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2  61b0c52f-a902-4769-9a09-c6628335b00a  fe930be7-5e62-47db-91af-98c3a49a38b1  /administrativeUnits/1a89e663-efcc-4911-8df7-e954714005de  null        2023-11-15T12:24:32.773Z  null         Assigned        Direct      5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2  36bd668f-3a40-455f-a40a-64074fde4a18                                [object Object]
+  5wuT_mJe20eRr5jDpJo4seCabNh9bS9BgvTNJIBCEKw-1                       d86c9ae0-6d7d-412f-82f4-cd24804210ac  fe930be7-5e62-47db-91af-98c3a49a38b1  /                                                          null        2024-02-12T08:47:02.91Z   null         Assigned        Direct      5wuT_mJe20eRr5jDpJo4seCabNh9bS9BgvTNJIBCEKw-1                       5f2c16a0-4212-4fa2-afae-fc8bfdc527b6                                [object Object]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,principalId,roleDefinitionId,directoryScopeId,appScopeId,startDateTime,endDateTime,assignmentType,memberType,roleAssignmentOriginId,roleAssignmentScheduleId
+  5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2,61b0c52f-a902-4769-9a09-c6628335b00a,fe930be7-5e62-47db-91af-98c3a49a38b1,/administrativeUnits/1a89e663-efcc-4911-8df7-e954714005de,,2023-11-15T12:24:32.773Z,,Assigned,Direct,5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2,36bd668f-3a40-455f-a40a-64074fde4a18
+  5wuT_mJe20eRr5jDpJo4seCabNh9bS9BgvTNJIBCEKw-1,d86c9ae0-6d7d-412f-82f4-cd24804210ac,fe930be7-5e62-47db-91af-98c3a49a38b1,/,,2024-02-12T08:47:02.91Z,,Assigned,Direct,5wuT_mJe20eRr5jDpJo4seCabNh9bS9BgvTNJIBCEKw-1,5f2c16a0-4212-4fa2-afae-fc8bfdc527b6
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra pim role assignment list
+
+  Date: 2/23/2024
+
+  ## 5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2
+
+  Property | Value
+  ---------|-------
+  id | 5wuT\_mJe20eRr5jDpJo4sS\_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2
+  principalId | 61b0c52f-a902-4769-9a09-c6628335b00a
+  roleDefinitionId | fe930be7-5e62-47db-91af-98c3a49a38b1
+  directoryScopeId | /administrativeUnits/1a89e663-efcc-4911-8df7-e954714005de
+  startDateTime | 2023-11-15T12:24:32.773Z
+  assignmentType | Assigned
+  memberType | Direct
+  roleAssignmentOriginId | 5wuT\_mJe20eRr5jDpJo4sS\_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2
+  roleAssignmentScheduleId | 36bd668f-3a40-455f-a40a-64074fde4a18
+  ```
+
+  </TabItem>
+</Tabs>
+
+### `includePrincipalDetails` response
+
+When we make use of the option `includePrincipalDetails` the response will differ. 
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2",
+      "principalId": "61b0c52f-a902-4769-9a09-c6628335b00a",
+      "roleDefinitionId": "fe930be7-5e62-47db-91af-98c3a49a38b1",
+      "directoryScopeId": "/administrativeUnits/1a89e663-efcc-4911-8df7-e954714005de",
+      "appScopeId": null,
+      "startDateTime": "2023-11-15T12:24:32.773Z",
+      "endDateTime": null,
+      "assignmentType": "Assigned",
+      "memberType": "Direct",
+      "roleAssignmentOriginId": "5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2",
+      "roleAssignmentScheduleId": "36bd668f-3a40-455f-a40a-64074fde4a18",
+      "roleDefinition": {
+        "displayName": "User Administrator"
+      },
+      "principal": {
+        "id": "61b0c52f-a902-4769-9a09-c6628335b00a",
+        "displayName": "Adele Vance",
+        "userPrincipalName": "AdeleV@contoso.onmicrosoft.com",
+        "mail": "AdeleV@contoso.onmicrosoft.com",
+        "businessPhones": [
+          "+1 425 555 0109"
+        ],
+        "givenName": "Adele",
+        "jobTitle": "Retail Manager",
+        "mobilePhone": null,
+        "officeLocation": "18/2111",
+        "preferredLanguage": "en-US",
+        "surname": "Vance"
+    }
+  }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                                                  principalId                           roleDefinitionId                      directoryScopeId                                           appScopeId  startDateTime             endDateTime  assignmentType  memberType  roleAssignmentOriginId                                              roleAssignmentScheduleId                                            roleDefinition   principal
+  ------------------------------------------------------------------  ------------------------------------  ------------------------------------  ---------------------------------------------------------  ----------  ------------------------  -----------  --------------  ----------  ------------------------------------------------------------------  ------------------------------------------------------------------  ---------------  ---------------
+  5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2  61b0c52f-a902-4769-9a09-c6628335b00a  fe930be7-5e62-47db-91af-98c3a49a38b1  /administrativeUnits/1a89e663-efcc-4911-8df7-e954714005de  null        2023-11-15T12:24:32.773Z  null         Assigned        Direct      5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2  36bd668f-3a40-455f-a40a-64074fde4a18                                [object Object]  [object Object]
+  5wuT_mJe20eRr5jDpJo4seCabNh9bS9BgvTNJIBCEKw-1                       d86c9ae0-6d7d-412f-82f4-cd24804210ac  fe930be7-5e62-47db-91af-98c3a49a38b1  /                                                          null        2024-02-12T08:47:02.91Z   null         Assigned        Direct      5wuT_mJe20eRr5jDpJo4seCabNh9bS9BgvTNJIBCEKw-1                       5f2c16a0-4212-4fa2-afae-fc8bfdc527b6                                [object Object]  [object Object]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,principalId,roleDefinitionId,directoryScopeId,appScopeId,startDateTime,endDateTime,assignmentType,memberType,roleAssignmentOriginId,roleAssignmentScheduleId
+  5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2,61b0c52f-a902-4769-9a09-c6628335b00a,fe930be7-5e62-47db-91af-98c3a49a38b1,/administrativeUnits/1a89e663-efcc-4911-8df7-e954714005de,,2023-11-15T12:24:32.773Z,,Assigned,Direct,5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2,36bd668f-3a40-455f-a40a-64074fde4a18
+  5wuT_mJe20eRr5jDpJo4seCabNh9bS9BgvTNJIBCEKw-1,d86c9ae0-6d7d-412f-82f4-cd24804210ac,fe930be7-5e62-47db-91af-98c3a49a38b1,/,,2024-02-12T08:47:02.91Z,,Assigned,Direct,5wuT_mJe20eRr5jDpJo4seCabNh9bS9BgvTNJIBCEKw-1,5f2c16a0-4212-4fa2-afae-fc8bfdc527b6
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra pim role assignment list --includePrincipalDetails "true"
+
+  Date: 3/31/2024
+
+  ## 5wuT_mJe20eRr5jDpJo4sS_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2
+
+  Property | Value
+  ---------|-------
+  id | 5wuT\_mJe20eRr5jDpJo4sS\_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2
+  principalId | 61b0c52f-a902-4769-9a09-c6628335b00a
+  roleDefinitionId | fe930be7-5e62-47db-91af-98c3a49a38b1
+  directoryScopeId | /administrativeUnits/1a89e663-efcc-4911-8df7-e954714005de
+  startDateTime | 2023-11-15T12:24:32.773Z
+  assignmentType | Assigned
+  memberType | Direct
+  roleAssignmentOriginId | 5wuT\_mJe20eRr5jDpJo4sS\_FsGECqWlHmgnGYoM1sApj5okazO8RSY336VRxQAXe-2
+  roleAssignmentScheduleId | 36bd668f-3a40-455f-a40a-64074fde4a18
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/contenttype/contenttype-sync.mdx

@@ -0,0 +1,144 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo contenttype sync
+
+Adds a published content type from the content type hub to a site or syncs its latest changes.
+
+## Usage
+
+```sh
+m365 spo contenttype sync [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The site to sync the Content Type to.
+
+`-i, --id [id]`
+: The Id of the published Content Type to sync from the Content Type Hub. Specify either `id` or `name`.
+
+`-n, --name [name]`
+: The name of the published Content Type to sync from the Content Type Hub. Specify either `id` or `name`.
+
+`--listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`. Omit to sync as a site content type.
+
+`--listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`. Omit to sync as a site content type.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`. Omit to sync as a site content type.
+```
+
+<Global />
+
+## Examples
+
+Syncs a given published content type from the hub to the specified site.
+
+```sh
+m365 spo contenttype sync —webUrl https://contoso.sharepoint.com/sites/sales --id 0x01007926A45D687BA842B947286090B8F67D
+```
+
+Syncs a given published content type from the hub to the specified site and adds it to the specified list.
+
+```sh
+m365 spo contenttype sync —webUrl https://contoso.sharepoint.com/sites/sales --id 0x01007926A45D687BA842B947286090B8F67D --listTitle Contacts
+```
+
+## Response
+
+:::info
+
+This command will only return a response if the content type is added to the site initially. When syncing the content type, no response is returned.  
+
+:::
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#contentType",
+    "@odata.type": "#microsoft.graph.contentType",
+    "@odata.etag": "\"2\"",
+    "id": "0x0101003D510887202C894AB7CD88CCE011519D",
+    "isBuiltIn": false,
+    "description": "",
+    "group": "Custom Content Types",
+    "hidden": false,
+    "name": "Dummy",
+    "parentId": "0x0101",
+    "readOnly": true,
+    "sealed": false,
+    "base": {
+      "id": "0x0101",
+      "description": "Create a new document.",
+      "group": "Document Content Types",
+      "hidden": false,
+      "name": "Document",
+      "readOnly": false,
+      "sealed": false
+    }
+  }
+  ```
+
+  </TabItem>
+   <TabItem value="Text">
+
+  ```text
+  @odata.context: https://graph.microsoft.com/v1.0/$metadata#contentType
+  @odata.etag   : "2"
+  @odata.type   : #microsoft.graph.contentType
+  base          : {"id":"0x0101","description":"Create a new document.","group":"Document Content Types","hidden":false,"name":"Document","readOnly":false,"sealed":false}
+  description   :
+  group         : Custom Content Types
+  hidden        : false
+  id            : 0x01010004448644DB17414A9F1174B4FBFD9AC1
+  isBuiltIn     : false
+  name          : Dummy
+  parentId      : 0x0101
+  readOnly      : true
+  sealed        : false
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  @odata.context,@odata.type,@odata.etag,id,isBuiltIn,description,group,hidden,name,parentId,readOnly,sealed
+  https://graph.microsoft.com/v1.0/$metadata#contentType,#microsoft.graph.contentType,"""2""",0x010100F4ACBE99F2DBDE42B0487A561A40F9EE,,,Custom Content Types,,Dummy,0x0101,1,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo contenttype sync --webUrl "https://contoso.sharepoint.com/sites/project-x" --name "Dummy"
+
+  Date: 13/03/2024
+
+  ## Dummy (0x010100F4ACBE99F2DBDE42B0487A561A40F9EE)
+
+  Property | Value
+  ---------|-------
+  @odata.context | https://graph.microsoft.com/v1.0/$metadata#contentType
+  @odata.type | #microsoft.graph.contentType
+  @odata.etag | "2"
+  id | 0x010100F4ACBE99F2DBDE42B0487A561A40F9EE
+  isBuiltIn | false
+  description |
+  group | Custom Content Types
+  hidden | false
+  name | Dummy 5
+  parentId | 0x0101
+  readOnly | true
+  sealed | false
+  ```
+
+  </TabItem>
+</Tabs>

package/package.json

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