< Back

New-SharedMailbox

Tue Jan 14, 2020 12:53 am

NAME New-SharedMailbox



SYNOPSIS

Create a Shared Mailbox with a default configuration





SYNTAX

New-SharedMailbox [-Name] <String> [[-DisplayName] <String>] [-Alias] <String> [[-Users] <String[]>]

[[-OrganizationalUnit] <String>] [[-Database] <String>] [[-Send] <String>] [<CommonParameters>]





DESCRIPTION





PARAMETERS

-Name <String>

Will show as the name for the contact and mailbox



Required? true

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



-DisplayName <String>

The name that appears in the Exchange Management Console under Recipient Configuration



Required? false

Position? 2

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Alias <String>

Emaill address excluding @example.com



Required? true

Position? 3

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Users <String[]>

Users that initially use the mailbox



Required? false

Position? 4

Default value

Accept pipeline input? false

Accept wildcard characters? false



-OrganizationalUnit <String>

Path to shared mailbox user account, not an AD OU Path



Required? false

Position? 5

Default value bhs.internal/BHS/Mail Users

Accept pipeline input? false

Accept wildcard characters? false



-Database <String>

mailbox database storage location



Required? false

Position? 6

Default value BHS Staff Mailbox Database

Accept pipeline input? false

Accept wildcard characters? false



-Send <String>

Users will get permission to send "<user> On behald of <account>", directly from <account> or not at all.



Required? false

Position? 7

Default value Behalf

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

Microsoft.Exchange.Data.Directory.Management.Mailbox





NOTES





Order of operations;

new shared mailbox in correct DN

Assign mailbox send parameters

Add persmissions for each user

Check to add full send-from persmission from switch

Add send on behalf permission

Return mailbox



Permissions:

There's levels have been discovered in testing and not researched. Enterprise Administrators would be the top

level that can do anything to exchange.

The ability to Set-MailboxSentItemsConfiguration requires "Enterprise Administrators" group membership with

the credentials used for import-mailserver.

Creating the mailbox and assigning permissions requires only "Organization Management" membership.



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>New-SharedMailbox -Name "AddressTitle" -DisplayName "Full Address Title" -Alias "address" -Users "personA",

"PersonB"



Name Alias

---- -----

AddressTitle address









-------------------------- EXAMPLE 2 --------------------------



PS C:\\>New-SharedMailbox -Name reports -DisplayName Reports -Alias reports -Users OfficeAdmin,Receptionist



Name Alias ServerName ProhibitSendQuota

---- ----- ---------- -----------------

reports reports exchange01 unlimited











RELATED LINKS