Chore/samples (#117)

* Add samples.

Co-authored-by: Vincent Biret <[email protected]>

Author: calebkiage

samples/1-Login.md

@@ -0,0 +1,27 @@
+## Login
+
+### Login with default client id & tenant id
+
+```sh
+mgc login --scopes User.ReadWrite Mail.ReadWrite
+```
+
+### Login with custom client id & tenant id
+
+```sh
+mgc login --scopes User.ReadWrite Mail.ReadWrite --client-id <client id> --tenant-id <tenant id>
+```
+
+### Login using previously consented permissions
+
+```sh
+mgc login --scopes User.ReadWrite Mail.ReadWrite --client-id <client id> --tenant-id <tenant id>
+```
+
+## Logout
+
+Forget access tokens
+
+```sh
+mgc logout
+```

samples/2-TenantInformation.md

@@ -0,0 +1,23 @@
+## Tenant information
+
+### Organization contact details
+
+```sh
+mgc organization list
+```
+
+```sh
+mgc organization list --select "DisplayName, City, State, Country, PostalCode, BusinessPhones"
+```
+
+### List application registrations in the tenant
+
+```sh
+mgc organization list --select "DisplayName, id, SignInAudience"
+```
+
+### List service principals in the tenant
+
+```sh
+mgc organization list --select "id, AppDisplayName" --query "value[?contains(appDisplayName, 'powershell')]"
+```

samples/3-UsersAndGroups.md

@@ -0,0 +1,80 @@
+## Microsoft Graph Users and Groups Snippets
+
+### List of Users
+
+```sh
+mgc users list --select "id, displayName, OfficeLocation, BusinessPhones"
+```
+
+### List users with count
+
+```sh
+mgc users list --top 5 --count --consistency-level eventual
+```
+
+### List of users with no Office Location
+
+```sh
+mgc users list --select "id, displayName, OfficeLocation, BusinessPhones" --query "value[?!officeLocation]"
+```
+
+### Update the location of the user
+
+```sh
+mgc users item patch --user-id <UserId> --body '{"officeLocation": "NewLocation"}'
+```
+
+### Get all Groups
+
+```sh
+mgc groups list --select "id, DisplayName, GroupTypes"
+```
+
+### Get all unified (Microsoft 365 Groups) Groups
+
+```sh
+mgc groups list --filter "groupTypes/any(c:c eq 'Unified')"
+```
+
+### Get-Details of a single Group
+
+```sh
+mgc groups item get --group-id <GroupId>
+```
+
+### Get Owners of a Group
+
+```sh
+mgc groups item owners list --group-id <GroupId>
+```
+
+### Get Members of a Group
+
+```sh
+mgc groups members list --group-id <GroupId>
+```
+
+### Get your mail
+
+```sh
+mgc users item messages list --user-id <UserId> --filter "contains(subject,'Marketing')" --select "sentDateTime, subject"
+```
+
+### New Group
+
+```sh
+mgc groups create --body '{"displayName": "PowerFam", "mailEnabled": false, "mailNickName": "powerfam", "securityEnabled": true}'
+```
+
+### Remove Group
+
+```sh
+mgc groups item delete --group-id <GroupId>
+```
+
+### Create a new User
+
+```sh
+mgc users create --body '{"displayName": "Bob Brown", "accountEnabled": true, "passwordProfile": {"password": "password"},\
+        "mailNickname": "Bob.Brown", "userPrincipalName": "bob.brown@{tenantdomain}"}'
+```

samples/4-Teams.md

@@ -0,0 +1,65 @@
+### Create a new team
+
+```sh
+mgc teams create --body '{"displayName": "2020 Interns", "description": "2020 Interns", \
+    "additionalProperties": {
+        "[email protected]" = "https://graph.microsoft.com/v1.0/teamsTemplates('standard')"
+    }}'
+```
+
+### Filter groups by displayName and resourceProvisioningOptions to find team
+
+```sh
+mgc groups list --filter "StartsWith(DisplayName, '$TeamName')" --query "value[?contains(resourceProvisioningOptions, 'Team')]"
+```
+
+### Add team owner
+
+```sh
+mgc users get --user-id "{TEAM_OWNER_UPN}"
+mgc teams item members create --team-id <TeamId> --body '{"additionalProperties": {\
+        "@odata.type": "#microsoft.graph.aadUserConversationMember",\
+        "[email protected]": "https://graph.microsoft.com/v1.0/users/" + $teamOwner.id\
+    }, "roles": ["owner"]}'
+```
+
+### Send a welcome message to the channel
+
+```sh
+mgc teams item primary-channel get --team-id <TeamId>
+mgc teams item channels item messages create --team-id <TeamId> --channel-id <ChannelId> --body '{"body": {"content": "Welcome to Teams!"}}'
+```
+
+### Delete team
+
+```sh
+mgc groups delete --group-id <GroupId>
+```
+
+### Teams Chat snippets
+
+#### Get list of 1:1 chats
+
+```sh
+mgc chats list
+```
+
+#### Get Messages from Chat
+
+```sh
+mgc chats item messages list --chat-id <ChatId>
+```
+
+#### Send a message in that 1:1 chat
+
+```sh
+mgc chats item messages create --chat-id <ChatId> --body '{"body": {"content": "Hi from CLI!"}}'
+```
+
+#### Mention a user in a channel message
+
+```sh
+mgc users item get --user-id <UserId> --select "id, displayName, userIdentityType"
+mgc teams item channels item messages create --team-id <TeamId> --channel-id <ChannelId> \
+    --body $'{"body": {"contentType": "html", "content": "Welcome to the channel <at id=\'0\'>[DisplayName]</at>!"}, "mentions": [{"id": 0, "mentionText": "[DisplayName]", "mentioned": {"user": {"id": "[id]", "displayName": "[DisplayName]", "userIdentityType": "aadUser"}}}]}'
+```

samples/5-Sites.md

@@ -0,0 +1,37 @@
+## Microsoft Graph Sites Snippets
+
+### Get root site
+
+```sh
+mgc sites item get --site-id root --select "id, displayName"
+```
+
+### Search for sites
+
+```sh
+mgc sites list --search "marketing" --select "displayName, description, webUrl"
+```
+
+### Get Id for marketing site
+
+```sh
+mgc sites list --search "marketing" --select id
+```
+
+### Get Site Pages
+
+```sh
+mgc sites item sites list --site-id <SiteId>
+```
+
+### Get Site Lists
+
+```sh
+mgc sites item sites list --site-id <SiteId> --select "id, displayName"
+```
+
+### Get Document Libraries
+
+```sh
+mgc sites item drive get --site-id <SiteId>
+```

samples/6-Drives.md

@@ -0,0 +1,13 @@
+## Drive snippets
+
+### Get drives
+
+```sh
+mgc drives list
+```
+
+### Get drive list
+
+```sh
+mgc drives item list get --drive-id <DriveId>
+```