@pnp/cli-microsoft365 10.5.0-beta.d99742c → 10.6.0-beta.195c8d5

package/dist/utils/prompt.js

@@ -6,13 +6,20 @@ let inquirerSelect;
 ;
 ;
 export const prompt = {
-    /* c8 ignore next 9 */
+    /* c8 ignore next 16 */
     async forInput(config) {
         if (!inquirerInput) {
             inquirerInput = await import('@inquirer/input');
         }
         const errorOutput = cli.getSettingWithDefaultValue(settingsNames.errorOutput, 'stderr');
-        return inquirerInput.default(config, { output: errorOutput === 'stderr' ? process.stderr : process.stdout });
+        return inquirerInput
+            .default(config, { output: errorOutput === 'stderr' ? process.stderr : process.stdout })
+            .catch(error => {
+            if (error instanceof Error && error.name === 'ExitPromptError') {
+                return ''; // noop; handle Ctrl + C
+            }
+            throw error;
+        });
     },
     /* c8 ignore next 9 */
     async forConfirmation(config) {

package/dist/utils/spo.js

@@ -519,10 +519,11 @@ export const spo = {
     },
     /**
    * Retrieves the spo user by email.
+   * Returns a user object
    * @param webUrl Web url
    * @param email The email of the user
    * @param logger the Logger object
-   * @param verbose set for verbose logging
+   * @param verbose Set for verbose logging
    */
     async getUserByEmail(webUrl, email, logger, verbose) {
         if (verbose && logger) {
@@ -593,10 +594,11 @@ export const spo = {
     },
     /**
     * Retrieves the spo group by name.
+    * Returns a group object
     * @param webUrl Web url
     * @param name The name of the group
     * @param logger the Logger object
-    * @param verbose set for verbose logging
+    * @param verbose Set for verbose logging
     */
     async getGroupByName(webUrl, name, logger, verbose) {
         if (verbose && logger) {
@@ -615,10 +617,13 @@ export const spo = {
     },
     /**
     * Retrieves the role definition by name.
+    * Returns a RoleDefinition object
+    * Returns a RoleDefinition object
     * @param webUrl Web url
     * @param name the name of the role definition
     * @param logger the Logger object
-    * @param verbose set for verbose logging
+    * @param verbose Set for verbose logging
+    * @param verbose Set for verbose logging
     */
     async getRoleDefinitionByName(webUrl, name, logger, verbose) {
         if (verbose && logger) {
@@ -1753,6 +1758,30 @@ export const spo = {
             responseType: 'json'
         };
         return request.post(requestOptions);
+    },
+    /**
+    * Get a role definition by name
+    * Returns a RoleDefinition object
+    * @param webUrl The web url
+    * @param name  the name of the role definition
+    * @param logger The logger object
+    * @param verbose Set for verbose logging
+    */
+    async getRoleDefintionByName(webUrl, name, logger, verbose) {
+        if (verbose && logger) {
+            await logger.logToStderr(`Retrieving the role definition by name ${name}`);
+        }
+        const response = await odata.getAllItems(`${webUrl}/_api/web/roledefinitions`);
+        const roleDefinition = response.find((role) => role.Name === name);
+        if (!roleDefinition) {
+            throw new Error(`The specified role definition name '${name}' does not exist.`);
+        }
+        const permissions = new BasePermissions();
+        permissions.high = roleDefinition.BasePermissions.High;
+        permissions.low = roleDefinition.BasePermissions.Low;
+        roleDefinition.BasePermissionsValue = permissions.parse();
+        roleDefinition.RoleTypeKindValue = RoleType[roleDefinition.RoleTypeKind];
+        return roleDefinition;
     }
 };
 //# sourceMappingURL=spo.js.map

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

@@ -137,6 +137,19 @@ m365 booking business get --name 'business name'
   email             : runningdevadmin@contoso.onmicrosoft.com
   id                : Accounting@contoso.onmicrosoft.com
   phone             :
+  address           : {city:"",countryOrRegion:"",postalCode:"",state:"",street:""}
+  businessHours     : [{day:"monday",timeSlots:[{endTime:"17:00:00.0000000",startTime:"08:00:00.0000000"}]},{day:"tuesday",timeSlots:[{endTime:"17:00:00.0000000",startTime:"08:00:00.0000000"}]},{day:"wednesday",timeSlots:[{endTime:"17:00:00.0000000",startTime:"08:00:00.0000000"}]},{day:"thursday",timeSlots:[{endTime:"17:00:00.0000000",startTime:"08:00:00.0000000"}]},{day:"friday",timeSlots:[{endTime:"17:00:00.0000000",startTime:"08:00:00.0000000"}]},{day:"saturday",timeSlots:[]},{day:"sunday",timeSlots:[]}]
+  businessType      : "Financial services"
+  defaultCurrencyIso: "USD"
+  displayName       : "Accounting"
+  email             : "runningdevadmin@contoso.onmicrosoft.com"
+  id                : "Accounting@contoso.onmicrosoft.com"
+  isPublished       : true
+  languageTag       : ""
+  phone             : ""
+  publicUrl         : "https://outlook.office365.com/owa/calendar/Accounting@contoso.onmicrosoft.com/bookings/"
+  schedulingPolicy  : {allowStaffSelection:true,maximumAdvance:"P365D",minimumLeadTime:"P1D",sendConfirmationsToOwner:true,timeSlotInterval:"PT30M"}
+  webSiteUrl        : ""
   ```
 
   </TabItem>

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

@@ -16,7 +16,7 @@ m365 entra policy list [options]
 
 ```md definition-list
 `-t, --type [type]`
-: The type of policies to return. Allowed values `activityBasedTimeout`, `authorization`, `claimsMapping`, `homeRealmDiscovery`, `identitySecurityDefaultsEnforcement`, `tokenIssuance`, `tokenLifetime`. If omitted, all policies are returned.
+: The type of policies to return. Allowed values `activityBasedTimeout`, `adminConsentRequest`, `appManagement`, `authenticationFlows`, `authenticationMethods`, `authenticationStrength`, `authorization`, `claimsMapping`, `conditionalAccess`, `crossTenantAccess`, `defaultAppManagement`, `deviceRegistration`, `featureRolloutPolicy`, `homeRealmDiscovery`, `identitySecurityDefaultsEnforcement`, `permissionGrant`, `roleManagement`, `tokenIssuance`, `tokenLifetime`. If omitted, all policies are returned.
 ```
 
 <Global />

package/docs/docs/cmd/entra/user/user-guest-add.mdx

@@ -105,6 +105,17 @@ m365 entra user guest add --emailAddress john.doe@contoso.com --messageLanguage
   resetRedemption        : false
   sendInvitationMessage  : true
   status                 : PendingAcceptance
+  id                     : "35f7f726-c541-4aef-a64e-a7b6868fe47f"
+  inviteRedeemUrl        : "https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3db373bc30-03b3-49bc-be72-9dd3e9027da8%26user%3d35f7f726-c541-4aef-a64e-a7b6868fe47f%26ticket%3dCjO3u3ZpQF2uthfZETfZ8gURzod5egvYI0uhaSN1Loo%25253d%26ver%3d2.0"
+  inviteRedirectUrl      : "https://myapplications.microsoft.com/"
+  invitedUser            : {id:"5257b5b2-4056-4a45-a05e-df5c92d53e6e"}
+  invitedUserDisplayName : "John Doe"
+  invitedUserEmailAddress: "john.doe@contoso.com"
+  invitedUserMessageInfo : {ccRecipients:[{emailAddress:{address:"maria.jones@contoso.com",name:null}}],customizedMessageBody:"Hi John, welcome to the organization!",messageLanguage:"en-US"}
+  invitedUserType        : "Guest"
+  resetRedemption        : false
+  sendInvitationMessage  : true
+  status                 : "PendingAcceptance"
   ```
 
   </TabItem>

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

@@ -137,6 +137,8 @@ m365 flow environment get
   location         : india
   name             : Default-d87a7535-dd31-4437-bfe1-95340acd55c5
   provisioningState: Succeeded
+  properties       : {azureRegionHint:"centralindia",cluster:{category:"Prod",environment:"Prod",geoShortName:"IN",number:"101",uriSuffix:"in-il101.gateway.prod.island"},createdBy:{displayName:"SYSTEM",id:"SYSTEM",type:"NotSpecified"},createdTime:"2019-12-21T18:32:11.8708704Z",creationType:"DefaultTenant",displayName:"contoso (default)",environmentFeatures:{isOpenApiEnabled:false},environmentSku:"Default",environmentType:"NotSpecified",governanceConfiguration:{protectionLevel:"Basic"},isDefault:true,isPayAsYouGoEnabled:false,linkedEnvironmentMetadata:{baseLanguage:1033,createdTime:"2019-12-25T15:46:14.433Z",domainName:"orgfc80770f",friendlyName:"contoso (default)",instanceApiUrl:"https://orgfc80770f.api.crm8.dynamics.com",instanceState:"Ready",instanceUrl:"https://orgfc80770f.crm8.dynamics.com/",resourceId:"3aa550bf-52ac-42fc-98f7-5d1833c1501c",type:"NotSpecified",uniqueName:"orgfc80770f",version:"9.2.22105.00154"},provisioningState:"Succeeded",runtimeEndpoints:{microsoft.ApiManagement:"https://management.INDIA.azure-apihub.net",microsoft.BusinessAppPlatform:"https://india.api.bap.microsoft.com",microsoft.CommonDataModel:"https://india.api.cds.microsoft.com",microsoft.Flow:"https://india.api.flow.microsoft.com",microsoft.PowerApps:"https://india.api.powerapps.com",microsoft.PowerAppsAdvisor:"https://india.api.advisor.powerapps.com",microsoft.PowerVirtualAgents:"https://powervamg.in-il101.gateway.prod.island.powerapps.com"},states:{management:{id:"NotSpecified"},runtime:{id:"Enabled",requestedBy:{displayName:"SYSTEM",type:"NotSpecified"},runtimeReasonCode:"NotSpecified"}}}
+  type             : "Microsoft.ProcessSimple/environments"
   ```
 
   </TabItem>

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

@@ -284,8 +284,10 @@ m365 flow get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --n
   actions    : OpenApiConnection-AnalyzeImageV2, Compose, InitializeVariable, OpenApiConnection-HttpRequest, ParseJson, OpenApiConnection-PatchFileItem
   description:
   displayName: My Flow
+  id         : /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/ca76d7b8-3b76-4050-8c03-9fb310ad172f
   name       : ca76d7b8-3b76-4050-8c03-9fb310ad172f
   triggers   : OpenApiConnection
+  type       : Microsoft.ProcessSimple/environments/flows
   ```
 
   </TabItem>

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

@@ -16,22 +16,22 @@ m365 flow run get [options]
 
 ```md definition-list
 `-n, --name <name>`
-: The name of the run to get information about
+: The name of the run to get information about.
 
 `--flowName <flowName>`
-: The name of the Power Automate flow for which to retrieve information
+: The name of the Power Automate flow for which to retrieve information.
 
 `-e, --environmentName <environmentName>`
 : The name of the environment where the flow is located
 
 `--includeTriggerInformation`
-: (deprecated. Use option `withTrigger` instead) If specified, include information about the trigger details
+: (deprecated. Use option `withTrigger` instead) If specified, include information about the trigger details.
 
 `--withTrigger`
-: If specified, include information about the trigger details
+: If specified, include information about the trigger details.
 
 `--withActions [withActions]`
-: If specified, include information about all actions when no action names are specified, or provide a specified list of actions separated by commas to include only the relevant action details
+: If specified, include information about all actions when no action names are specified, or provide a specified list of actions separated by commas to include only the relevant action details.
 
 ```
 
@@ -55,13 +55,13 @@ If the option `withTrigger` is specified, but the trigger does not contain an ou
 
 ## Examples
 
-Get information about the given run of the specified Power Automate flow
+Get information about the given run of the specified Power Automate flow.
 
 ```sh
 m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
 ```
 
-Get information about the given run of the specified Power Automate flow including trigger information
+Get information about the given run of the specified Power Automate flow including trigger information.
 
 ```sh
 m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --withTrigger
@@ -73,7 +73,7 @@ Get information about the given run of the specified Power Automate flow includi
 m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --withActions
 ```
 
-Get information about the given run of the specified Power Automate flow including exclusively the details of 'Action_Internal_Name1' and 'Action_Internal_Name2' actions
+Get information about the given run of the specified Power Automate flow including exclusively the details of 'Action_Internal_Name1' and 'Action_Internal_Name2' actions.
 
 ```sh
 m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --withActions "Action_Internal_Name1,Action_Internal_Name2"
@@ -137,11 +137,15 @@ m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
   <TabItem value="Text">
 
   ```text
-  endTime    : 2023-03-04T09:05:22.5880202Z
-  name       : 08585236861638480597867166179CU104
-  startTime  : 2023-03-04T09:05:21.8066368Z
-  status     : Succeeded
-  triggerName: When_an_email_is_flagged_(V4)
+  correlation: {"clientTrackingId":"08585329112602833829909892130CU00"}
+  endTime    : 
+  id         : /providers/Microsoft.ProcessSimple/environments/Default-de348bc7-1aeb-4406-8cb3-97db021cadb4/flows/170fb67e-a514-4d84-8727-582022bd13a9/runs/08585329112602833828909892130CU17
+  name       : 08585329112602833828909892130CU17
+  properties : {"correlation":{"clientTrackingId":"08585329112602833829909892130CU00"},"startTime":"2022-11-17T14:33:45.2763872Z","status":"Running","trigger":{"correlation":{"clientTrackingId":"08585329112602833829909892130CU00"},"endTime":"2022-11-17T14:33:45.1914506Z","inputsLink":{"contentHash":{"algorithm":"md5","value":"6ZrBBE+MJg7IvhMgyJLMmA=="},"contentSize":349,"contentVersion":"6ZrBBE+MJg7IvhMgyJLMmA==","uri":"https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerInputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerInputs%2Fread&sv=1.0&sig="},"name":"When_a_new_response_is_submitted","originHistoryName":"08585329112602833829909892130CU00","outputsLink":{"contentHash":{"algorithm":"md5","value":"Z/4a8tfYygNAR1xpc44iww=="},"contentSize":493,"contentVersion":"Z/4a8tfYygNAR1xpc44iww==","uri":"https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerOutputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerOutputs%2Fread&sv=1.0&sig="},"startTime":"2022-11-17T14:33:45.1914506Z","status":"Succeeded"}}
+  startTime  : 2022-11-17T14:33:45.2763872Z
+  status     : Running
+  triggerName: When_a_new_response_is_submitted
+  type       : Microsoft.ProcessSimple/environments/flows/runs
   ```
 
   </TabItem>

package/docs/docs/cmd/graph/directoryextension/directoryextension-get.mdx

@@ -38,16 +38,15 @@ m365 graph directoryextension get [options]
 Get directory extension by id registered for an application specified by app id.
 
 ```sh
-m365 directoryextension get --id 1f0f15e3-925d-40f0-8fc8-9d3ad135bce0 --appId fd918e4b-c821-4efb-b50a-5eddd23afc6f
+m365 graph directoryextension get --id 1f0f15e3-925d-40f0-8fc8-9d3ad135bce0 --appId fd918e4b-c821-4efb-b50a-5eddd23afc6f
 ```
 
 Get directory extension by name registered for an application specified by name.
 
 ```sh
-m365 directoryextension get --name extension_105be60b603845fea385e58772d9d630_GitHubWorkAccount --appName ContosoApp
+m365 graph directoryextension get --name extension_105be60b603845fea385e58772d9d630_GitHubWorkAccount --appName ContosoApp
 ```
 
-
 ## Response
 
 <Tabs>

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

@@ -0,0 +1,120 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph openextension add
+
+Adds an open extension to a resource
+
+## Usage
+
+```sh
+m365 graph openextension add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the open extension.
+
+`-i, --resourceId <resourceId>`
+: The Id of the resource for which the extension is created.
+
+`-t, --resourceType <resourceType>`
+: The resource type for which the extension is created. Allowed values are `user`, `group`, `device`, `organization`.
+```
+
+<Global />
+
+## Remarks
+
+This command allows using unknown options to add custom data to the open extension.
+
+When adding an open extension to a user, it's possible to use the UPN as the resourceId.
+
+:::warning[Escaping JSON in PowerShell]
+
+When creating open extensions it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
+
+:::
+
+## Examples
+
+Create a new open extension for a user specified by id. Extension properties are specified by unknown options.
+
+```sh
+m365 graph openextension add --resourceId eb77fbcf-6fe8-458b-985d-1747284793bc --resourceType user --name 'com.contoso.roamingSettings' --theme dark --color red --language English
+```
+
+Create a new open extension for a user specified by userName. Extension properties are specified by unknown options.
+
+```sh
+m365 graph openextension add --resourceId adelev@contoso.com --resourceType user --name 'com.contoso.roamingSettings' --theme dark --color red --language English
+```
+
+Create a new open extension for a group, one of the property represents a JSON object
+
+```sh
+m365 graph openextension add --resourceId eb77fbcf-6fe8-458b-985d-1747284793bc --resourceType group --name 'com.contoso.roamingSettings' --settings '{"theme": "dark", "color": "red", "language": "English"}' --supportedSystem 'Linux'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "extensionName": "com.contoso.roamingSettings",
+    "settings": {
+      "theme": "dark",
+      "color": "red",
+      "language": "English"
+    },
+    "supportedSystem": "Linux",
+    "id": "com.contoso.roamingSettings"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  extensionName  : com.contoso.roamingSettings
+  id             : com.contoso.roamingSettings
+  settings       : {"theme":"dark","color":"red","language":"English"}
+  supportedSystem: Linux
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  extensionName,supportedSystem,id
+  com.contoso.roamingSettings,Linux,com.contoso.roamingSettings
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # graph openextension add --name "com.contoso.roamingSettings" --resourceId "01b62bc5-9701-4f93-9587-9d1ea58a086d" --resourceType "user" --settings "{"theme": "dark", "color": "red", "language": "English"}" --supportedSystem "Linux"
+
+  Date: 3/13/2025
+
+  ## com.contoso.roamingSettings
+
+  Property | Value
+  ---------|-------
+  extensionName | com.contoso.roamingSettings
+  supportedSystem | Linux
+  id | com.contoso.roamingSettings
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Open extensions: https://learn.microsoft.com/graph/api/opentypeextension-post-opentypeextension

package/docs/docs/cmd/graph/openextension/openextension-get.mdx

@@ -0,0 +1,111 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph openextension get
+
+Retrieves a specific open extension for a resource
+
+## Usage
+
+```sh
+m365 graph openextension get [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the open extension to retrieve.
+
+`-i, --resourceId <resourceId>`
+: The Id of the resource for which to retrieve the open extension.
+
+`-t, --resourceType <resourceType>`
+: The type of resource. Allowed values are `user`, `group`, `device`, `organization`.
+```
+
+<Global />
+
+## Examples
+
+Retrieve a specified open extension for a user specified by id.
+
+```sh
+m365 graph openextension get --resourceId eb77fbcf-6fe8-458b-985d-1747284793bc --name 'com.contoso.roamingSettings' --resourceType user
+```
+
+Retrieve a specified open extension for a user specified by UPN.
+
+```sh
+m365 graph openextension get --resourceId john.doe@contoso.com --name 'com.contoso.roamingSettings' --resourceType user
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "extensionName": "com.contoso.roamingSettings",
+    "name": "com.contoso.roamingSettings",
+    "resourceId": "john.doe@contoso.com",
+    "resourceType": "user",
+    "theme": "dark",
+    "color": "red",
+    "language": "English",
+    "id": "com.contoso.roamingSettings"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  color        : red
+  extensionName: com.contoso.roamingSettings
+  id           : com.contoso.roamingSettings
+  language     : English
+  name         : com.contoso.roamingSettings
+  resourceId   : john.doe@contoso.com
+  resourceType : user
+  theme        : dark
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  extensionName,name,resourceId,resourceType,theme,color,language,id
+  com.contoso.roamingSettings,com.contoso.roamingSettings,john.doe@contoso.com,user,dark,red,English,com.contoso.roamingSettings
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # graph openextension get --debug "false" --verbose "false" --resourceId "john.doe@contoso.com" --resourceType "user" --name "com.contoso.roamingSettings"
+
+  Date: 2025-04-07
+
+  ## com.contoso.roamingSettings (com.contoso.roamingSettings)
+
+  Property | Value
+  ---------|-------
+  extensionName | com.contoso.roamingSettings
+  name | com.contoso.roamingSettings
+  resourceId | john.doe@contoso.com
+  resourceType | user
+  theme | dark
+  color | red
+  language | English
+  id | com.contoso.roamingSettings
+  ```
+  
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Open extensions: https://learn.microsoft.com/graph/extensibility-overview?tabs=http#open-extensions

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

@@ -0,0 +1,129 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph openextension list
+
+Retrieves all open extensions for a resource
+
+## Usage
+
+```sh
+m365 graph openextension list [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --resourceId <resourceId>`
+: The Id of the resource for which to retrieve open extensions.
+
+`-t, --resourceType <resourceType>`
+: The type of resource. Allowed values are `user`, `group`, `device`, `organization`.
+```
+
+<Global />
+
+## Examples
+
+Retrieve open extensions for a user specified by id
+
+```sh
+m365 graph openextension list --resourceId eb77fbcf-6fe8-458b-985d-1747284793bc --resourceType user
+```
+
+Retrieve open extensions for a user specified by UPN
+
+```sh
+m365 graph openextension list --resourceId john.doe@contoso.com --resourceType user
+```
+
+Retrieve open extensions for a group specified by id
+
+```sh
+m365 graph openextension list --resourceId 19588303-70bf-44a4-beb1-e2f0f1ed06b3 --resourceType group
+```
+
+Retrieve open extensions for an organization specified by id
+
+```sh
+m365 graph openextension list --resourceId c956e711-f074-40c3-8431-fbd69bb67d9c --resourceType organization
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "extensionName": "com.contoso.roamingSettings",
+      "theme": "dark",
+      "color": "purple",
+      "lang": "Japanese",
+      "id": "com.contoso.roamingSettings"
+    },
+    {
+      "extensionName": "com.test.m365",
+      "settings": {
+        "theme": "dark"
+      },
+      "supportedSystem": "Linux",
+      "id": "com.test.m365"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  extensionName                id
+  ---------------------------  ---------------------------
+  com.contoso.roamingSettings  com.contoso.roamingSettings
+  com.test.m365                com.test.m365
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  extensionName,theme,color,lang,id
+  com.contoso.roamingSettings,dark,purple,Japanese,com.contoso.roamingSettings
+  com.test.m365,,,,com.test.m365
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # graph openextension list --resourceId "eb77fbcf-6fe8-458b-985d-1747284793bc" --resourceType "user"
+
+  Date: 3/29/2025
+
+  ## com.contoso.roamingSettings
+
+  Property | Value
+  ---------|-------
+  extensionName | com.contoso.roamingSettings
+  theme | dark
+  color | purple
+  lang | Japanese
+  id | com.contoso.roamingSettings
+
+  ## com.test.m365
+
+  Property | Value
+  ---------|-------
+  extensionName | com.test.m365
+  supportedSystem | Linux
+  id | com.test.m365
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Open extensions: https://learn.microsoft.com/graph/extensibility-overview?tabs=http#open-extensions