@pnp/cli-microsoft365 6.8.0-beta.f473be5 → 6.9.0-beta.148279d

package/docs/docs/cmd/pp/solution/solution-remove.mdx

@@ -0,0 +1,86 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# pp solution remove
+
+Removes the specified solution in the specified Power Platform environment
+
+## Usage
+
+```sh
+m365 pp solution remove [options]
+```
+
+## Options
+
+```md definition-list
+`-e, --environment <environment>`
+: The name of the environment.
+
+`-i, --id [id]`
+: The id of the solution. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: The unique name (not the display name) of the solution. Specify either `id` or `name` but not both.
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to.
+
+`--confirm`
+: Don't prompt for confirmation
+```
+
+<Global />
+
+## Examples
+
+Removes the specified solution with a specific name, owned by the currently signed-in user
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name"
+```
+
+Removes the specified solution owned by the currently signed-in user based on the name parameter without confirmation
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name" --confirm
+```
+
+Removes the specified solution owned by another user based on the name parameter
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name" --asAdmin
+```
+
+Removes the specified solution owned by another user based on the name parameter without confirmation
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "solution Name" --asAdmin --confirm
+```
+
+Removes the specified solution owned by the currently signed-in user based on the id parameter
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b
+```
+
+Removes the specified solution owned by the currently signed-in user based on the id parameter without confirmation
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --confirm
+```
+
+Removes the specified solution owned by another user based on the id parameter
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --asAdmin
+```
+
+Removes the specified solution owned by another user based on the id parameter without confirmation
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --asAdmin --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pp/tenant/tenant-settings-list.mdx

@@ -0,0 +1,140 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pp tenant settings list
+
+Lists the global Power Platform tenant settings
+
+## Usage
+
+```sh
+m365 pp tenant settings list [options]
+```
+
+## Options
+
+<Global />
+
+## Remarks
+
+:::caution
+
+This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+:::
+
+## Examples
+
+Lists the global Power Platform settings of the tenant
+
+```sh
+m365 pp tenant settings list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "walkMeOptOut": false,
+    "disableNPSCommentsReachout": false,
+    "disableNewsletterSendout": false,
+    "disableEnvironmentCreationByNonAdminUsers": false,
+    "disablePortalsCreationByNonAdminUsers": false,
+    "disableSurveyFeedback": false,
+    "disableTrialEnvironmentCreationByNonAdminUsers": false,
+    "disableCapacityAllocationByEnvironmentAdmins": false,
+    "disableSupportTicketsVisibleByAllUsers": false,
+    "powerPlatform": {
+      "search": {
+        "disableDocsSearch": false,
+        "disableCommunitySearch": false,
+        "disableBingVideoSearch": false
+      },
+      "teamsIntegration": {
+        "shareWithColleaguesUserLimit": 10000
+      },
+      "powerApps": {
+        "disableShareWithEveryone": false,
+        "enableGuestsToMake": false,
+        "disableMembersIndicator": false,
+        "disableMakerMatch": false,
+        "disableUnusedLicenseAssignment": false
+      },
+      "environments": {
+        "disablePreferredDataLocationForTeamsEnvironment": false
+      },
+      "governance": {
+        "disableAdminDigest": true,
+        "disableDeveloperEnvironmentCreationByNonAdminUsers": false,
+        "enableDefaultEnvironmentRouting": false
+      },
+      "licensing": {
+        "disableBillingPolicyCreationByNonAdminUsers": false,
+        "storageCapacityConsumptionWarningThreshold": 85
+      },
+      "powerPages": {},
+      "champions": {
+        "disableChampionsInvitationReachout": false,
+        "disableSkillsMatchInvitationReachout": false
+      },
+      "intelligence": {
+        "disableCopilot": false,
+        "enableOpenAiBotPublishing": false
+      },
+      "modelExperimentation": {
+        "enableModelDataSharing": false
+      }
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  disableCapacityAllocationByEnvironmentAdmins  : false
+  disableEnvironmentCreationByNonAdminUsers     : false
+  disableNPSCommentsReachout                    : false
+  disablePortalsCreationByNonAdminUsers         : false
+  disableSupportTicketsVisibleByAllUsers        : false
+  disableSurveyFeedback                         : false
+  disableTrialEnvironmentCreationByNonAdminUsers: false
+  walkMeOptOut                                  : false
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  walkMeOptOut,disableNPSCommentsReachout,disableNewsletterSendout,disableEnvironmentCreationByNonAdminUsers,disablePortalsCreationByNonAdminUsers,disableSurveyFeedback,disableTrialEnvironmentCreationByNonAdminUsers,disableCapacityAllocationByEnvironmentAdmins,disableSupportTicketsVisibleByAllUsers
+  ,,,,,,,,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # pp tenant settings list
+
+  Date: 6/2/2023
+
+  Property | Value
+  ---------|-------
+  walkMeOptOut | false
+  disableNPSCommentsReachout | false
+  disableNewsletterSendout | false
+  disableEnvironmentCreationByNonAdminUsers | false
+  disablePortalsCreationByNonAdminUsers | false
+  disableSurveyFeedback | false
+  disableTrialEnvironmentCreationByNonAdminUsers | false
+  disableCapacityAllocationByEnvironmentAdmins | false
+  disableSupportTicketsVisibleByAllUsers | false
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/pp/tenant/tenant-settings-set.mdx

@@ -0,0 +1,235 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pp tenant settings set
+
+Sets the global Power Platform configuration of the tenant
+
+## Usage
+
+```sh
+m365 pp tenant settings set [options]
+```
+
+## Options
+
+```md definition-list
+`--walkMeOptOut [walkMeOptOut]`
+: Ability to opt out of guided experiences using WalkMe in Power Platform. Valid values: `true`, `false`.
+
+`--disableNPSCommentsReachout [disableNPSCommentsReachout]`
+: Ability to disable re-surveying users who left prior feedback via NPS prompts in Power Platform. Valid values: `true`, `false`.
+
+`--disableNewsletterSendout [disableNewsletterSendout]`
+: Ability to disable the newsletter sendout feature. Valid values: `true`, `false`.
+
+`--disableEnvironmentCreationByNonAdminUsers [disableEnvironmentCreationByNonAdminUsers]`
+: Restrict all environments to be created by Global Admins, Power Platform Admins, or Dynamics365 Service Admins. Valid values: `true`, `false`.
+
+`--disablePortalsCreationByNonAdminUsers [disablePortalsCreationByNonAdminUsers]`
+: Restrict all portals to be created by Global Admins, Power Platform Admins, or Dynamics365 Service Admins. Valid values: `true`, `false`.
+
+`--disableSurveyFeedback [disableSurveyFeedback]`
+: Ability to disable all NPS survey feedback prompts in Power Platform. Valid values: `true`, `false`.
+
+`--disableTrialEnvironmentCreationByNonAdminUsers [disableTrialEnvironmentCreationByNonAdminUsers]`
+: Restrict all trial environments to be created by Global Admins, Power Platform Admins, or Dynamics365 Service Admins. Valid values: `true`, `false`.
+
+`--disableCapacityAllocationByEnvironmentAdmins [disableCapacityAllocationByEnvironmentAdmins]`
+: Ability to disable capacity allocation by environment administrators. Valid values: `true`, `false`.
+
+`--disableSupportTicketsVisibleByAllUsers [disableSupportTicketsVisibleByAllUsers]`
+: Ability to disable support ticket creation by non-admin users in the tenant. Valid values: `true`, `false`.
+
+`--disableDocsSearch [disableDocsSearch]`
+: When this setting is true, users in the environment will see a message that Microsoft Learn and Documentation search categories have been turned off by the administrator in the search results page. Valid values: `true`, `false`.
+
+`--disableCommunitySearch [disableCommunitySearch]`
+: When this setting is true, users in the environment will see a message that Community and Blog search categories have been turned off by the administrator in the search results page. Valid values: `true`, `false`.
+
+`--disableBingVideoSearch [disableBingVideoSearch]`
+: When this setting is true, users in the environment will see a message that video search categories have been turned off by the administrator in the search results page. Valid values: `true`, `false`.
+
+`--shareWithColleaguesUserLimit [shareWithColleaguesUserLimit]`
+: Maximum value setting for the number of users in a security group used to share an app built using Power Apps on Microsoft Teams. Specify any number as a value.
+
+`--disableShareWithEveryone [disableShareWithEveryone]`
+: Ability to disable the Share With Everyone capability in all Power Apps. Valid values: `true`, `false`.
+
+`--enableGuestsToMake [enableGuestsToMake]`
+: Ability to allow guest users in your tenant to create Power Apps. Valid values: `true`, `false`.
+
+`--disableMembersIndicator [disableMembersIndicator]`
+: Ability to disable the display of a members indicator. Valid values: `true`, `false`.
+
+`--disableMakerMatch [disableMakerMatch]`
+: Ability to disable the Maker Match feature, which helps organizations find internal resources with the necessary skills to develop custom apps and solutions using Power Platform. Valid values: `true`, `false`.
+
+`--disablePreferredDataLocationForTeamsEnvironment [disablePreferredDataLocationForTeamsEnvironment]`
+: Ability to disable the selection of a preferred data location for Teams environment. Valid values: `true`, `false`.
+
+`--disableAdminDigest [disableAdminDigest]`
+: When true, the entire organization is unsubscribed from the weekly digest. Valid values: `true`, `false`.
+
+`--disableDeveloperEnvironmentCreationByNonAdminUsers [disableDeveloperEnvironmentCreationByNonAdminUsers]`
+: Restrict all developer environments to be created by Global Admins, Power Platform Admins, or Dynamics365 Service Admins. Valid values: `true`, `false`.
+
+`--disableBillingPolicyCreationByNonAdminUsers [disableBillingPolicyCreationByNonAdminUsers]`
+: Restrict billing policies to be created by Global Admins, Power Platform Admins, or Dynamics365 Service Admins. Valid values: `true`, `false`.
+
+`--storageCapacityConsumptionWarningThreshold [storageCapacityConsumptionWarningThreshold]`
+: Ability to set a threshold for storage capacity consumption warnings. Specify any number as a value.
+
+`--disableChampionsInvitationReachout [disableChampionsInvitationReachout]`
+: Ability to disable all invitations to become a Power Platform champion. Valid values: `true`, `false`.
+
+`--disableSkillsMatchInvitationReachout [disableSkillsMatchInvitationReachout]`
+: Ability to disable all skills match invitations to become part of the makers community. Valid values: `true`, `false`.
+
+`--disableCopilot [disableCopilot]`
+: Ability to turn off or disable the Copilot feature. Valid values: `true`, `false`.
+
+`--enableOpenAiBotPublishing [enableOpenAiBotPublishing]`
+: Ability to enable or disable the publishing of OpenAI bots within the organization's environment. Valid values: `true`, `false`.
+
+`--enableModelDataSharing [enableModelDataSharing]`
+: Ability to enable or disable the sharing of model data within the organization's environment. Valid values: `true`, `false`.
+```
+
+<Global />
+
+## Remarks
+
+:::caution
+
+This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+:::
+
+## Examples
+
+Disable environment creation for non-admin users
+
+```sh
+m365 pp tenant settings set --disableEnvironmentCreationByNonAdminUsers true --disableTrialEnvironmentCreationByNonAdminUsers true --disableDeveloperEnvironmentCreationByNonAdminUsers true
+```
+
+Enable Power App creation for guest users
+
+```sh
+m365 pp tenant settings set --enableGuestsToMake true
+```
+
+Disable guided experience, survey feedback and newsletter
+
+```sh
+m365 pp tenant settings set --walkMeOptOut true --disableNewsletterSendout true --disableSurveyFeedback true
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "walkMeOptOut": false,
+    "disableNPSCommentsReachout": false,
+    "disableNewsletterSendout": false,
+    "disableEnvironmentCreationByNonAdminUsers": false,
+    "disablePortalsCreationByNonAdminUsers": false,
+    "disableSurveyFeedback": false,
+    "disableTrialEnvironmentCreationByNonAdminUsers": false,
+    "disableCapacityAllocationByEnvironmentAdmins": false,
+    "disableSupportTicketsVisibleByAllUsers": false,
+    "powerPlatform": {
+      "search": {
+        "disableDocsSearch": false,
+        "disableCommunitySearch": false,
+        "disableBingVideoSearch": false
+      },
+      "teamsIntegration": {
+        "shareWithColleaguesUserLimit": 10000
+      },
+      "powerApps": {
+        "disableShareWithEveryone": false,
+        "enableGuestsToMake": false,
+        "disableMembersIndicator": false,
+        "disableMakerMatch": false
+      },
+      "environments": {
+        "disablePreferredDataLocationForTeamsEnvironment": false
+      },
+      "governance": {
+        "disableAdminDigest": false,
+        "disableDeveloperEnvironmentCreationByNonAdminUsers": false
+      },
+      "licensing": {
+        "disableBillingPolicyCreationByNonAdminUsers": false,
+        "storageCapacityConsumptionWarningThreshold": 85
+      },
+      "powerPages": {},
+      "champions": {
+        "disableChampionsInvitationReachout": false,
+        "disableSkillsMatchInvitationReachout": false
+      },
+      "intelligence": {
+        "disableCopilot": false,
+        "enableOpenAiBotPublishing": false
+      },
+      "modelExperimentation": {
+        "enableModelDataSharing": false
+      }
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  disableCapacityAllocationByEnvironmentAdmins  : false
+  disableEnvironmentCreationByNonAdminUsers     : false
+  disableNPSCommentsReachout                    : false
+  disableNewsletterSendout                      : false
+  disablePortalsCreationByNonAdminUsers         : false
+  disableSupportTicketsVisibleByAllUsers        : false
+  disableSurveyFeedback                         : false
+  disableTrialEnvironmentCreationByNonAdminUsers: false
+  powerPlatform                                 : {"search":{"disableDocsSearch":false,"disableCommunitySearch":false,"disableBingVideoSearch":false},"teamsIntegration":{"shareWithColleaguesUserLimit":10000},"powerApps":{"disableShareWithEveryone":false,"enableGuestsToMake":false,"disableMembersIndicator":false,"disableMakerMatch":false},"environments":{"disablePreferredDataLocationForTeamsEnvironment":false},"governance":{"disableAdminDigest":false,"disableDeveloperEnvironmentCreationByNonAdminUsers":false},"licensing":{"disableBillingPolicyCreationByNonAdminUsers":false,"storageCapacityConsumptionWarningThreshold":85},"powerPages":{},"champions":{"disableChampionsInvitationReachout":false,"disableSkillsMatchInvitationReachout":false},"intelligence":{"disableCopilot":false,"enableOpenAiBotPublishing":false},"modelExperimentation":{"enableModelDataSharing":false}}
+  walkMeOptOut                                  : false
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  walkMeOptOut,disableNPSCommentsReachout,disableNewsletterSendout,disableEnvironmentCreationByNonAdminUsers,disablePortalsCreationByNonAdminUsers,disableSurveyFeedback,disableTrialEnvironmentCreationByNonAdminUsers,disableCapacityAllocationByEnvironmentAdmins,disableSupportTicketsVisibleByAllUsers
+  ,,,,,,,,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # pp tenant settings set --disableEnvironmentCreationByNonAdminUsers false --disableTrialEnvironmentCreationByNonAdminUsers false --disableDeveloperEnvironmentCreationByNonAdminUsers false
+
+  Date: 14/3/2023
+
+  Property | Value
+  ---------|-------
+  walkMeOptOut | false
+  disableNPSCommentsReachout | false
+  disableNewsletterSendout | false
+  disableEnvironmentCreationByNonAdminUsers | false
+  disablePortalsCreationByNonAdminUsers | false
+  disableSurveyFeedback | false
+  disableTrialEnvironmentCreationByNonAdminUsers | false
+  disableCapacityAllocationByEnvironmentAdmins | false
+  disableSupportTicketsVisibleByAllUsers | false
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/purview/auditlog/auditlog-list.mdx

@@ -0,0 +1,145 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# purview auditlog list
+
+List audit logs within your tenant
+
+## Usage
+
+```sh
+m365 purview auditlog list [options]
+```
+
+## Options
+
+```md definition-list
+`--contentType <contentType>`
+: Content type of logs to retrieve. Possible values: `AzureActiveDirectory`, `Exchange`, `SharePoint`, `General`, `DLP`.
+
+`--startTime [startTime]`
+: Time indicating the **inclusive** start of a time range of content to return. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z). Start time cannot be more than 7 days in the past. Default value is 24h ago.
+
+`--endTime [endTime]`
+: Time indicating the **exclusive** end of a time range of content to return. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z). Default value is now.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+Before you can access audit log data, you must enable unified audit logging for your Microsoft 365 tenant. For instructions, check out the page [Turn auditing on or off](https://learn.microsoft.com/en-us/microsoft-365/compliance/audit-log-enable-disable).
+
+:::
+
+:::info
+
+When running this command for the first time for a certain content type, a subscription for this content type is created. It can take up to 12 hours for the first content blobs to become available for that subscription.
+
+:::
+
+:::tip
+
+Retrieving audit logs is an intensive process, especially for large or active tenants. In this case it may take some time to retrieve all audit logs. It can be useful to add the `--verbose` option to your command to view the command progress.
+
+:::
+
+When you specify a value for `contentType`, consider the following:
+
+- `AzureActiveDirectory` includes all Azure AD audit logs.
+- `Exchange` includes all Exchange audit logs.
+- `SharePoint` includes all SharePoint audit logs.
+- `General` includes all other workloads not included in the previous content types.
+- `DLP` DLP events only for all workloads.
+
+## Examples
+
+List all SharePoint audit logs for the past 24 hours
+
+```sh
+m365 purview auditlog list --contentType SharePoint
+```
+
+List all SharePoint audit logs within a specific time frame
+
+```sh
+m365 purview auditlog list --contentType SharePoint --startTime "2023-01-01T00:00:00Z" --endTime "2023-01-03T09:00:00Z"
+```
+
+Get all SharePoint audit logs within a specific time frame and save the logs to a file
+
+```sh
+m365 purview auditlog list --contentType SharePoint --startTime "2023-01-01T00:00:00Z" --endTime "2023-01-01T12:00:00Z" > auditLogs.json
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "AppAccessContext": {
+          "ClientAppId": "94bfad6e-a0b3-4eb9-8e2b-83eeb335de28",
+          "CorrelationId": "040d86a0-f096-5000-d4b4-baac627b75f3",
+          "UniqueTokenId": "5CVDGmrynkGYBkY-MPynAA"
+      },
+      "CreationTime": "2023-01-10T00:00:00",
+      "Id": "4d671836-c772-4169-55f9-08dae745c839",
+      "Operation": "ListItemViewed",
+      "OrganizationId": "6e40c2aa-0565-4013-b38c-d5e6f0c42993",
+      "RecordType": 36,
+      "UserKey": "i:0i.t|00000003-0000-0ff1-ce00-000000000000|app@sharepoint",
+      "UserType": 0,
+      "Version": 1,
+      "Workload": "SharePoint",
+      "ClientIP": "168.63.104.32",
+      "ObjectId": "https://contoso.sharepoint.com/sites/Project-x/Lists/cae414a1-ac65-4a90-844e-651d7a1e463d/305_.000",
+      "UserId": "john.doe@contoso.com",
+      "ApplicationId": "94bfad6e-a0b3-4eb9-8e2b-83eeb335de28",
+      "CorrelationId": "040d86a0-f096-5000-d4b4-baac627b75f3",
+      "EventSource": "SharePoint",
+      "ItemType": "ListItem",
+      "ListId": "cae414a1-ac65-4a90-844e-651d7a1e463d",
+      "ListItemUniqueId": "2d364471-4d27-4186-b139-072c8225ee4a",
+      "Site": "51f5a236-b2e5-4a6d-a81d-13d188610155",
+      "UserAgent": "NONISV|Contoso|ContosoApp/1.0",
+      "WebId": "38ab94aa-a904-4c2b-8467-4be0e457f97b",
+      "CustomizedDoclib": false,
+      "FromApp": false,
+      "ItemCount": 192,
+      "ListBaseTemplateType": "100",
+      "ListBaseType": "GenericList",
+      "ListColor": "",
+      "ListIcon": "",
+      "Source": "Unknown",
+      "TemplateTypeId": "",
+      "ListTitle": "cae414a1-ac65-4a90-844e-651d7a1e463d"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```txt
+  CreationTime         UserId                Operation       ObjectId                                                                                          
+  -------------------  --------------------  --------------  --------------------------------------------------------------------------------------------------
+  2023-01-10T00:00:00  john.doe@contoso.com  ListItemViewed  https://contoso.sharepoint.com/sites/Project-x/Lists/cae414a1-ac65-4a90-844e-651d7a1e463d/305_.000
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  CreationTime,UserId,Operation,ObjectId
+  2023-01-10T00:00:00,john.doe@contoso.com,ListItemViewed,https://contoso.sharepoint.com/sites/Project-x/Lists/cae414a1-ac65-4a90-844e-651d7a1e463d/305_.000
+  ```
+
+  </TabItem>
+</Tabs>
+