@pnp/cli-microsoft365 6.8.0 → 6.9.0-beta.1cd2525

package/docs/docs/cmd/aad/approleassignment/approleassignment-remove.md

@@ -1,65 +0,0 @@
-# aad approleassignment remove
-
-Deletes an app role assignment for the specified Azure AD Application Registration
-
-## Usage
-
-```sh
-m365 aad approleassignment remove [options]
-```
-
-## Options
-
-`--appId [appId]`
-: Application appId also known as clientId of the App Registration for which the configured scopes (app roles) should be deleted
-
-`--appObjectId [appObjectId]`
-: Application objectId of the App Registration for which the configured scopes (app roles) should be deleted
-
-`--appDisplayName [appDisplayName]`
-: Application name of the App Registration for which the configured scopes (app roles) should be deleted
-
-`-r, --resource <resource>`
-: Service principal name, appId or objectId that has the scopes (roles) e.g. `SharePoint`
-
-`-s, --scope <scope>`
-: Permissions known also as scopes and roles to be deleted from the application. If multiple permissions have to be deleted, they have to be comma-separated e.g. `Sites.Read.All`,`Sites.ReadWrite.All`
-
-`--confirm`
-: Don't prompt for confirming removing the all role assignment
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-This command requires tenant administrator permissions.
-
-Specify either the `appId`, `appObjectId` or `appDisplayName` but not multiple. If you specify more than one option value, the command will fail with an error.
-
-Autocomplete values for the `resource` option do not mean allowed values. The autocomplete will just suggest some known names, but that doesn't restrict you to use name of your own custom application or other application within your tenant.
-
-This command can also be used to assign permissions to system- or user-assigned managed identity.
-
-## Examples
-
-Deletes SharePoint _Sites.Read.All_ application permissions from Azure AD application with app id _57907bf8-73fa-43a6-89a5-1f603e29e451_
-
-```sh
-m365 aad approleassignment remove --appId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "SharePoint" --scope "Sites.Read.All"
-```
-
-Deletes multiple Microsoft Graph application permissions from an Azure AD application with name _MyAppName_
-
-```sh
-m365 aad approleassignment remove --appDisplayName "MyAppName" --resource "Microsoft Graph" --scope "Mail.Read,Mail.Send"
-```
-
-Deletes Microsoft Graph _Mail.Read_ application permissions from a system-managed identity app with objectId _57907bf8-73fa-43a6-89a5-1f603e29e451_
-
-```sh
-m365 aad approleassignment remove --appObjectId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "Microsoft Graph" --scope "Mail.Read"
-```
-
-## More information
-
-- Microsoft Graph permissions reference: [https://docs.microsoft.com/en-us/graph/permissions-reference](https://docs.microsoft.com/en-us/graph/permissions-reference)

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

@@ -1,127 +0,0 @@
-# aad group get
-
-Gets information about the specified Azure AD Group
-
-## Usage
-
-```sh
-m365 aad group get [options]
-```
-
-## Options
-
-`-i, --id [id]`
-: The object Id of the Azure AD group. Specify either `id` or `title` but not both
-
-`-t, --title [title]`
-: The display name of the Azure AD group. Specify either `id` or `title` but not both
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Get information about an Azure AD Group by id
-
-```sh
-m365 aad group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844
-```
-
-Get information about an Azure AD Group by title
-
-```sh
-m365 aad group get --title "Finance"
-```
-
-## Response
-
-=== "JSON"
-
-    ```json
-    {
-      "id": "c541afac-508e-40c7-8880-5a601b41737b",
-      "deletedDateTime": null,
-      "classification": null,
-      "createdDateTime": "2022-11-13T19:16:32Z",
-      "creationOptions": [
-        "YammerProvisioning"
-      ],
-      "description": "This is the default group for everyone in the network",
-      "displayName": "All Company",
-      "expirationDateTime": null,
-      "groupTypes": [
-        "Unified"
-      ],
-      "isAssignableToRole": null,
-      "mail": "allcompany@contoso.onmicrosoft.com",
-      "mailEnabled": true,
-      "mailNickname": "allcompany",
-      "membershipRule": null,
-      "membershipRuleProcessingState": null,
-      "onPremisesDomainName": null,
-      "onPremisesLastSyncDateTime": null,
-      "onPremisesNetBiosName": null,
-      "onPremisesSamAccountName": null,
-      "onPremisesSecurityIdentifier": null,
-      "onPremisesSyncEnabled": null,
-      "preferredDataLocation": null,
-      "preferredLanguage": null,
-      "proxyAddresses": [
-        "SPO:SPO_c3e7794d-0726-49ac-805b-2d6b0edaefdc@SPO_44744d00-3da0-45e5-9e28-da5ab48c61ac",
-        "SMTP:allcompany@contoso.onmicrosoft.com"
-      ],
-      "renewedDateTime": "2022-11-13T19:16:32Z",
-      "resourceBehaviorOptions": [
-        "CalendarMemberReadOnly"
-      ],
-      "resourceProvisioningOptions": [],
-      "securityEnabled": false,
-      "securityIdentifier": "S-1-12-1-4076547856-1079300050-1399127439-2879739702",
-      "theme": null,
-      "visibility": "Public",
-      "onPremisesProvisioningErrors": []
-    }
-    ```
-
-=== "Text"
-
-    ```text
-    classification               : null
-    createdDateTime              : 2022-11-13T19:16:32Z
-    creationOptions              : ["YammerProvisioning"]
-    deletedDateTime              : null
-    description                  : This is the default group for everyone in the network
-    displayName                  : All Company
-    expirationDateTime           : null
-    groupTypes                   : ["Unified"]
-    id                           : c541afac-508e-40c7-8880-5a601b41737b
-    isAssignableToRole           : null
-    mail                         : allcompany@contoso.onmicrosoft.com
-    mailEnabled                  : true
-    mailNickname                 : allcompany
-    membershipRule               : null
-    membershipRuleProcessingState: null
-    onPremisesDomainName         : null
-    onPremisesLastSyncDateTime   : null
-    onPremisesNetBiosName        : null
-    onPremisesProvisioningErrors : []
-    onPremisesSamAccountName     : null
-    onPremisesSecurityIdentifier : null
-    onPremisesSyncEnabled        : null
-    preferredDataLocation        : null
-    preferredLanguage            : null
-    proxyAddresses               : ["SPO:SPO_c3e7794d-0726-49ac-805b-2d6b0edaefdc@SPO_44744d00-3da0-45e5-9e28-da5ab48c61ac","SMTP:allcompany@contoso.onmicrosoft.com"]
-    renewedDateTime              : 2022-11-13T19:16:32Z
-    resourceBehaviorOptions      : ["CalendarMemberReadOnly"]
-    resourceProvisioningOptions  : []
-    securityEnabled              : false
-    securityIdentifier           : S-1-12-1-4076547856-1079300050-1399127439-2879739702
-    theme                        : null
-    visibility                   : Public
-    ```
-
-=== "CSV"
-
-    ```csv
-    id,deletedDateTime,classification,createdDateTime,creationOptions,description,displayName,expirationDateTime,groupTypes,isAssignableToRole,mail,mailEnabled,mailNickname,membershipRule,membershipRuleProcessingState,onPremisesDomainName,onPremisesLastSyncDateTime,onPremisesNetBiosName,onPremisesSamAccountName,onPremisesSecurityIdentifier,onPremisesSyncEnabled,preferredDataLocation,preferredLanguage,proxyAddresses,renewedDateTime,resourceBehaviorOptions,resourceProvisioningOptions,securityEnabled,securityIdentifier,theme,visibility,onPremisesProvisioningErrors
-    c541afac-508e-40c7-8880-5a601b41737b,,,2022-11-13T19:16:32Z,"[""YammerProvisioning""]",This is the default group for everyone in the network,All Company,,"[""Unified""]",,allcompany@contoso.onmicrosoft.com,1,allcompany,,,,,,,,,,,"[""SPO:SPO_c3e7794d-0726-49ac-805b-2d6b0edaefdc@SPO_44744d00-3da0-45e5-9e28-da5ab48c61ac"",""SMTP:allcompany@contoso.onmicrosoft.com""]",2022-11-13T19:16:32Z,"[""CalendarMemberReadOnly""]",[],,S-1-12-1-4076547856-1079300050-1399127439-2879739702,,Public,[]
-    ```

package/docs/docs/cmd/aad/group/group-list.md

@@ -1,30 +0,0 @@
-# aad group list
-
-Lists Azure AD groups
-
-## Usage
-
-```sh
-m365 aad group list [options]
-```
-
-## Options
-
-`-d, --deleted`
-: Use to retrieve deleted groups
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Lists all groups defined in Azure Active Directory.
-
-```sh
-m365 aad group list
-```
-
-List all recently deleted groups in the tenant
-
-```sh
-m365 aad group list --deleted
-```

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

@@ -1,36 +0,0 @@
-# aad groupsetting add
-
-Creates a group setting
-
-## Usage
-
-```sh
-m365 aad groupsetting add [options]
-```
-
-## Options
-
-`-i, --templateId <templateId>`
-: The ID of the group setting template to use to create the group setting
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-To create a group setting, you have to specify the ID of the group setting template that should be used to create the setting. You can retrieve the ID of the template using the [aad groupsettingtemplate list](../groupsettingtemplate/groupsettingtemplate-list.md) command.
-
-To specify values for the different properties specified in the group setting template, include additional options that match the property in the group setting template. For example `--ClassificationList 'HBI, MBI, LBI, GDPR'` will set the list of classifications to use on modern SharePoint sites.
-
-Each group setting template specifies default value for each property. If you don't specify a value for the particular property yourself, the default value from the group setting template will be used. To find out which properties are available for the particular group setting template, use the [aad groupsettingtemplate get](../groupsettingtemplate/groupsettingtemplate-get.md) command.
-
-If the specified templateId doesn't reference a valid group setting template, you will get a _Resource 'xyz' does not exist or one of its queried reference-property objects are not present._ error.
-
-If you try to add a group setting using a template, for which a setting already exists, you will get a _A conflicting object with one or more of the specified property values is present in the directory._ error.
-
-## Examples
-
-Configure classification for modern SharePoint sites
-
-```sh
-m365 aad groupsetting add --templateId 62375ab9-6b52-47ed-826b-58e47e0e304b --UsageGuidelinesUrl https://contoso.sharepoint.com/sites/compliance --ClassificationList 'HBI, MBI, LBI, GDPR' --DefaultClassification MBI
-```

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

@@ -1,24 +0,0 @@
-# aad groupsetting get
-
-Gets information about the particular group setting
-
-## Usage
-
-```sh
-m365 aad groupsetting get [options]
-```
-
-## Options
-
-`-i, --id <id>`
-: The ID of the group setting to retrieve
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Get information about the group setting with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
-
-```sh
-m365 aad groupsetting get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844
-```

package/docs/docs/cmd/aad/groupsetting/groupsetting-list.md

@@ -1,21 +0,0 @@
-# aad groupsetting list
-
-Lists Azure AD group settings
-
-## Usage
-
-```sh
-m365 aad groupsetting list [options]
-```
-
-## Options
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-List all group settings in the tenant
-
-```sh
-m365 aad groupsetting list
-```

package/docs/docs/cmd/aad/groupsetting/groupsetting-remove.md

@@ -1,37 +0,0 @@
-# aad groupsetting remove
-
-Removes the particular group setting
-
-## Usage
-
-```sh
-m365 aad groupsetting remove [options]
-```
-
-## Options
-
-`-i, --id <id>`
-: The ID of the group setting to remove
-
-`--confirm`
-: Don't prompt for confirming removing the group setting
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-If the specified _id_ doesn't refer to an existing group setting, you will get a `Resource does not exist` error.
-
-## Examples
-
-Remove group setting with id _28beab62-7540-4db1-a23f-29a6018a3848_. Will prompt for confirmation before removing the group setting
-
-```sh
-m365 aad groupsetting remove --id 28beab62-7540-4db1-a23f-29a6018a3848
-```
-
-Remove group setting with id _28beab62-7540-4db1-a23f-29a6018a3848_ without prompting for confirmation
-
-```sh
-m365 aad groupsetting remove --id 28beab62-7540-4db1-a23f-29a6018a3848 --confirm
-```

package/docs/docs/cmd/aad/groupsetting/groupsetting-set.md

@@ -1,34 +0,0 @@
-# aad groupsetting set
-
-Updates the particular group setting
-
-## Usage
-
-```sh
-m365 aad groupsetting set [options]
-```
-
-## Options
-
-`-i, --id <id>`
-: The ID of the group setting to update
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-To update a group setting, you have to specify the ID of the group setting. You can retrieve the ID of the group setting using the [aad groupsetting list](./groupsetting-list.md) command.
-
-To update values for the different properties specified in the group setting, include additional options that match the property in the group setting. For example `--ClassificationList 'HBI, MBI, LBI, GDPR'` will set the list of classifications to use on modern SharePoint sites.
-
-If you don't specify a value for the particular property, it will remain unchanged. To find out which properties are available for the particular group setting, use the [aad groupsetting get](./groupsetting-get.md) command.
-
-If the specified id doesn't reference a valid group setting, you will get a _Resource 'xyz' does not exist or one of its queried reference-property objects are not present._ error.
-
-## Examples
-
-Configure classification for modern SharePoint sites
-
-```sh
-m365 aad groupsetting set --id c391b57d-5783-4c53-9236-cefb5c6ef323 --UsageGuidelinesUrl https://contoso.sharepoint.com/sites/compliance --ClassificationList 'HBI, MBI, LBI, GDPR' --DefaultClassification MBI
-```

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

@@ -1,33 +0,0 @@
-# aad groupsettingtemplate get
-
-Gets information about the specified Azure AD group settings template
-
-## Usage
-
-```sh
-m365 aad groupsettingtemplate get [options]
-```
-
-## Options
-
-`-i, --id [id]`
-: The ID of the settings template to retrieve. Specify the `id` or `displayName` but not both
-
-`-n, --displayName [displayName]`
-: The display name of the settings template to retrieve. Specify the `id` or `displayName` but not both
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Get information about the group setting template with id _62375ab9-6b52-47ed-826b-58e47e0e304b_
-
-```sh
-m365 aad groupsettingtemplate get --id 62375ab9-6b52-47ed-826b-58e47e0e304b
-```
-
-Get information about the group setting template with display name _Group.Unified_
-
-```sh
-m365 aad groupsettingtemplate get --displayName Group.Unified
-```

package/docs/docs/cmd/aad/groupsettingtemplate/groupsettingtemplate-list.md

@@ -1,21 +0,0 @@
-# aad groupsettingtemplate list
-
-Lists Azure AD group settings templates
-
-## Usage
-
-```sh
-m365 aad groupsettingtemplate list [options]
-```
-
-## Options
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-List all group setting templates in the tenant
-
-```sh
-m365 aad groupsettingtemplate list
-```

package/docs/docs/cmd/aad/license/license-list.md

@@ -1,87 +0,0 @@
-# aad license list
-
-Lists commercial subscriptions that an organization has acquired
-
-## Usage
-
-```sh
-m365 aad license list [options]
-```
-
-## Options
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-List all licenses within the tenant
-
-```sh
-m365 aad license list
-```
-
-## Response
-
-=== "JSON"
-
-    ```json
-    [
-      {
-        "capabilityStatus": "Enabled",
-        "consumedUnits": 1,
-        "id": "48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df",
-        "skuId": "c7df2760-2c81-4ef7-b578-5b5392b571df",
-        "skuPartNumber": "ENTERPRISEPREMIUM",
-        "appliesTo": "User",
-        "prepaidUnits": {
-          "enabled": 10000,
-          "suspended": 0,
-          "warning": 0
-        },
-        "servicePlans": [
-            {
-                "servicePlanId": "8c098270-9dd4-4350-9b30-ba4703f3b36b",
-                "servicePlanName": "ADALLOM_S_O365",
-                "provisioningStatus": "Success",
-                "appliesTo": "User"
-            }
-        ]
-      }
-    ]
-    ```
-
-=== "Text"
-
-    ```text
-    id                                                                         skuId                                 skuPartNumber
-    -------------------------------------------------------------------------  ------------------------------------  ----------------------
-    48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df  c7df2760-2c81-4ef7-b578-5b5392b571df  ENTERPRISEPREMIUM
-    ```
-
-=== "CSV"
-
-    ```csv
-    id,skuId,skuPartNumber
-    48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df,c7df2760-2c81-4ef7-b578-5b5392b571df,ENTERPRISEPREMIUM
-    ```
-    
-=== "Markdown"
-
-    ```md
-    # aad license list
-
-    Date: 14/2/2023
-
-    ## 48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df
-
-    Property | Value
-    ---------|-------
-    capabilityStatus | Enabled
-    consumedUnits | 1
-    id | 48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df
-    skuId | c7df2760-2c81-4ef7-b578-5b5392b571df
-    skuPartNumber | ENTERPRISEPREMIUM
-    appliesTo | User
-    prepaidUnits | {"enabled":10000,"suspended":0,"warning":0}
-    servicePlans | [{"servicePlanId":"8c098270-9dd4-4350-9b30-ba4703f3b36b","servicePlanName": "ADALLOM_S_O365","provisioningStatus": "Success","appliesTo": "User"}]
-    ```

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

@@ -1,107 +0,0 @@
-# aad o365group add
-
-Creates a Microsoft 365 Group
-
-## Usage
-
-```sh
-m365 aad o365group add [options]
-```
-
-## Options
-
-`-n, --displayName <displayName>`
-: Display name for the Microsoft 365 Group
-
-`-d, --description <description>`
-: Description for the Microsoft 365 Group
-
-`-m, --mailNickname <mailNickname>`
-: Name to use in the group e-mail (part before the `@`)
-
-`--owners [owners]`
-: Comma-separated list of Microsoft 365 Group owners
-
-`--members [members]`
-: Comma-separated list of Microsoft 365 Group members
-
-`--isPrivate`
-: Specify, if the Microsoft 365 Group should be private. If not specified, will create a public group (default)
-
-`--allowMembersToPost [allowMembersToPost]`
-: Set if only group members should be able to post conversations to the group
-
-`--hideGroupInOutlook [hideGroupInOutlook]`
-: Set to hide the group in Outlook experiences
-
-`--subscribeNewGroupMembers [subscribeNewGroupMembers]`
-: Set to subscribe all new group members to receive group conversation emails when new messages are posted in the group
-
-`--welcomeEmailDisabled [welcomeEmailDisabled]`
-: Set to not send welcome emails to new group members
-
-`-l, --logoPath [logoPath]`
-: Local path to the image file to use as group logo
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-When specifying the path to the logo image you can use both relative and absolute paths. Note, that ~ in the path, will not be resolved and will most likely result in an error.
-If an invalid user is provided in the comma-separated list of Owners or Members, the command operation will fail and the Microsoft 365 Group will not be created.
-
-## Examples
-
-Create a public Microsoft 365 Group
-
-```sh
-m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance
-```
-
-Create a private Microsoft 365 Group
-
-```sh
-m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --isPrivate
-```
-
-Create a public Microsoft 365 Group and set specified users as its owners
-
-```sh
-m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --owners "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
-```
-
-Create a public Microsoft 365 Group and set specified users as its members
-
-```sh
-m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
-```
-
-Create a public Microsoft 365 Group and allow only group members to be able to post conversations to the group.
-
-```sh
-m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --allowMembersToPost
-```
-
-Create a public Microsoft 365 Group and hide it from the Outlook experiences (web and client).
-
-```sh
-m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --hideGroupInOutlook
-```
-
-Create a public Microsoft 365 Group and subscribe all new group members to receive group conversation emails when new messages are posted in the group.
-
-```sh
-m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --subscribeNewGroupMembers
-```
-
-Create a public Microsoft 365 Group and set to not send welcome emails to new group members.
-
-```sh
-m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --welcomeEmailDisabled
-```
-
-Create a public Microsoft 365 Group and set its logo
-
-```sh
-m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --logoPath images/logo.png
-```

package/docs/docs/cmd/aad/o365group/o365group-conversation-list.md

@@ -1,24 +0,0 @@
-# aad o365group conversation list
-
-Lists conversations for the specified Microsoft 365 group
-
-## Usage
-
-```sh
-m365 aad o365group conversation list [options]
-```
-
-## Options
-
-`-i, --groupId <groupId>`
-: The ID of the Microsoft 365 group
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Lists conversations for the specified Microsoft 365 group
-
-```sh
-m365 aad o365group conversation list --groupId '00000000-0000-0000-0000-000000000000'
-```