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

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'
-```

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

@@ -1,36 +0,0 @@
-# aad o365group conversation post list
-
-Lists conversation posts of a Microsoft 365 group
-
-## Usage
-
-```sh
-m365 aad o365group conversation post list [options]
-```
-
-## Options
-
-`-i, --groupId [groupId]`
-: The Id of the Office 365 Group. You can specify the groupId or groupDisplayName, but not both.
-
-`-d, --groupDisplayName [groupDisplayName]`
-: The Displayname of the Office 365 Group. You can specify the groupId or groupDisplayName, but not both.
-
-`-t, --threadId <threadId>`
-: The ID of the thread to retrieve details for
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Lists the posts of the specific conversation of Microsoft 365 group by groupId
-
-```sh
-m365 aad o365group conversation post list --groupId '00000000-0000-0000-0000-000000000000' --threadId 'AAQkADkwN2Q2NDg1LWQ3ZGYtNDViZi1iNGRiLTVhYjJmN2Q5NDkxZQAQAOnRAfDf71lIvrdK85FAn5E='
-```
-
-Lists the posts of the specific conversation of Microsoft 365 group by groupDisplayName
-
-```sh
-m365 aad o365group conversation post list --groupDisplayName 'MyGroup' --threadId 'AAQkADkwN2Q2NDg1LWQ3ZGYtNDViZi1iNGRiLTVhYjJmN2Q5NDkxZQAQAOnRAfDf71lIvrdK85FAn5E='
-```

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

@@ -1,33 +0,0 @@
-# aad o365group get
-
-Gets information about the specified Microsoft 365 Group or Microsoft Teams team
-
-## Usage
-
-```sh
-m365 aad o365group get [options]
-```
-
-## Options
-
-`-i, --id <id>`
-: The ID of the Microsoft 365 Group or Microsoft Teams team to retrieve information for
-
-`--includeSiteUrl`
-: Set to retrieve the site URL for the group
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
-
-```sh
-m365 aad o365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844
-```
-
-Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ and also retrieve the URL of the corresponding SharePoint site
-
-```sh
-m365 aad o365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSiteUrl
-```

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

@@ -1,81 +0,0 @@
-# aad o365group list
-
-Lists Microsoft 365 Groups in the current tenant
-
-## Usage
-
-```sh
-m365 aad o365group list [options]
-```
-
-## Options
-
-`-d, --displayName [displayName]`
-: Retrieve only groups with displayName starting with the specified value
-
-`-m, --mailNickname [displayName]`
-: Retrieve only groups with mailNickname starting with the specified value
-
-`--includeSiteUrl`
-: Set to retrieve the site URL for each group
-
-`--deleted`
-: Set to only retrieve deleted groups
-
-`--orphaned`
-: Set to only retrieve groups without owners
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-Using the `--includeSiteUrl` option, you can retrieve the URL of the site associated with the particular Microsoft 365 Group. If you however retrieve too many groups and will try to get their site URLs, you will most likely get an error as the command will get throttled, issuing too many requests, too frequently. If you get an error, consider narrowing down the result set using the `--displayName` and `--mailNickname` filters.
-
-Retrieving the URL of the site associated with the particular Microsoft 365 Group is not possible when retrieving deleted groups.
-
-Using the `--orphaned` option, you can retrieve Microsoft 365 Groups without owners.
-
-## Examples
-
-List all Microsoft 365 Groups in the tenant
-
-```sh
-m365 aad o365group list
-```
-
-List Microsoft 365 Groups with display name starting with _Project_
-
-```sh
-m365 aad o365group list --displayName Project
-```
-
-List Microsoft 365 Groups mail nick name starting with _team_
-
-```sh
-m365 aad o365group list --mailNickname team
-```
-
-List deleted Microsoft 365 Groups with display name starting with _Project_
-
-```sh
-m365 aad o365group list --displayName Project --deleted
-```
-
-List deleted Microsoft 365 Groups mail nick name starting with _team_
-
-```sh
-m365 aad o365group list --mailNickname team --deleted
-```
-
-List Microsoft 365 Groups with display name starting with _Project_ including
-the URL of the corresponding SharePoint site
-
-```sh
-m365 aad o365group list --displayName Project --includeSiteUrl
-```
-
-List Microsoft 365 Groups without owners
-
-```sh
-m365 aad o365group list --orphaned
-```

package/docs/docs/cmd/aad/o365group/o365group-recyclebinitem-clear.md

@@ -1,30 +0,0 @@
-# aad o365group recyclebinitem clear
-
-Clears Microsoft 365 Groups from the recycle bin in the current tenant
-
-## Usage
-
-```sh
-m365 aad o365group recyclebinitem clear [options]
-```
-
-## Options
-
-`--confirm`
-: Don't prompt for confirmation to clear the recycle bin items.
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Removes all deleted Microsoft 365 Groups in the tenant. Will prompt for confirmation before permanently removing groups.
-
-```sh
-m365 aad o365group recyclebinitem clear
-```
-
-Removes all deleted Microsoft 365 Groups in the tenant. Will NOT prompt for confirmation before permanently removing groups.
-
-```sh
-m365 aad o365group recyclebinitem clear --confirm
-```

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

@@ -1,45 +0,0 @@
-# aad o365group recyclebinitem list
-
-Lists Groups from the recycle bin in the current tenant
-
-## Usage
-
-```sh
-m365 aad o365group recyclebinitem list [options]
-```
-
-## Options
-
-`-d, --groupDisplayName [groupDisplayName]`
-: Lists groups with DisplayName starting with the specified value
-
-`-m, --groupMailNickname [groupMailNickname]`
-: Lists groups with MailNickname starting with the specified value
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-List all deleted Microsoft 365 Groups in the tenant
-
-```sh
-m365 aad o365group recyclebinitem list
-```
-
-List deleted Microsoft 365 Groups with display name starting with _Project_
-
-```sh
-m365 aad o365group recyclebinitem list --groupDisplayName Project
-```
-
-List deleted Microsoft 365 Groups mail nick name starting with _team_
-
-```sh
-m365 aad o365group recyclebinitem list --groupMailNickname team
-```
-
-List deleted Microsoft 365 Groups mail nick name starting with _team_ and with display name starting with _Project_
-
-```sh
-m365 aad o365group recyclebinitem list --groupMailNickname team --groupDisplayName Project
-```