doc/exchange_online.md

   1
   2 ## Setup
   3
   4 1. Start a cloud shell on the Exchange Admin website.
   5
   6 2. The cloud shell defaults to `bash`. Change it to `PowerShell`.
   7
   8 2. Run these commands once.
   9
  10     The results of these commands will persisit in your Cloud Shell attached Azure storage.
  11
  12     ```powershell
  13     Install-Module -Name PSWSMan -AcceptLicense -Confirm
  14     Install-WSMan   # Web services for management
  15     Import-Module ExchangeOnlineManagement
  16     ```
  17
  18 3. Repeat these commands for each new Cloud Shell
  19
  20     ```powershell
  21     Import-Module ExchangeOnlineManagement
  22     Connect-ExchangeOnline
  23     ```
  24
  25 ## Tasks
  26
  27 ### Distribution Group
  28
  29 A distribution list sends a copy of any incoming email to the inbox of every member. The list itself, has an email address, but does not have a mailbox, since a copy of every incoming message goes in the mailboxes of each list member.
  30
  31 1. Create distribution group
  32
  33     ```powershell
  34     $groupname = 'loves_tacos'
  35     new-distributiongroup $groupname
  36     ```
  37
  38 2. Add some folks to it
  39
  40     ```powershell
  41     Add-DistributionGroupMember -Identity $groupname -Member bob
  42     Add-DistributionGroupMember -Identity $groupname -Member larry
  43     ```
  44
  45 3. Verify the list is as desired
  46
  47
  48     ```powershell
  49     get-distributiongroupmember -identity $groupname
  50     ```
  51
  52 4. Add an email alias
  53
  54     ```powershell
  55     $domain = 'tacos.net'
  56     set-distributiongroup -identity $groupname -EmailAddresses @{add="$groupname@$domain"}
  57     get-distributiongroup $groupname | Select Alias, EmailAddresses, ManagedBy, DistinguishedName | Format-List
  58     ```
  59
  60
  61
  62 ### Or create an entire shared mailbox
  63
  64 A shared mailbox is an actual separate mailbox. Messages sent to it will not be copied into the mailboxes of the members with access. Members with access to a shared mailbox may also be allowed to send email out.
  65
  66 A shared mailbox should be used if:
  67
  68     - A team of people need to send email out from the email address
  69     - Each email should only be handled by one person.
  70
  71 > Warning: This recipe is likely incomplete, as I eventually decided not to use it.
  72
  73 1. Create a shared mailbox
  74
  75     ```powershell
  76     $groupname = 'tacos'
  77     $displayname = 'Loves Tacos'
  78     New-Mailbox -Shared -Name "$groupname" -DisplayName $displayname
  79     ```
  80
  81 2. Decide who to add.
  82
  83     You can review your mailbox users with `Get-Mailbox`
  84
  85 3. Add people
  86
  87     ```powershell
  88     Add-MailboxPermission -Identity $groupname -AccessRights FullAccess -User <user>
  89     ```
  90
  91 4. Review
  92
  93     ```powershell
  94     Get-MailboxPermission $groupname
  95     ```