EXOMailContact¶
Parameters¶
Parameter | Attribute | DataType | Description | Allowed Values |
---|---|---|---|---|
Name | Key | String | The Name parameter specifies a unique name for the mail contact. | |
ExternalEmailAddress | Required | String | The ExternalEmailAddress parameter specifies the target email address of the mail contact or mail user. By default, this value is used as the primary email address of the mail contact or mail user. | |
Alias | Write | String | The Alias parameter specifies the Exchange alias (also known as the mail nickname) for the recipient. This value identifies the recipient as a mail-enabled object, and shouldn't be confused with multiple email addresses for the same recipient (also known as proxy addresses). A recipient can have only one Alias value. The maximum length is 64 characters. | |
DisplayName | Write | String | The DisplayName parameter specifies the display name of the mail contact. The display name is visible in the Exchange admin center and in address lists. | |
FirstName | Write | String | The FirstName parameter specifies the user's first name. | |
Initials | Write | String | The Initials parameter specifies the user's middle initials. | |
LastName | Write | String | The LastName parameter specifies the user's last name. | |
MacAttachmentFormat | Write | String | The MacAttachmentFormat parameter specifies the Apple Macintosh operating system attachment format to use for messages sent to the mail contact or mail user. Valid values are: BinHex, UuEncode, AppleSingle, AppleDouble | BinHex , UuEncode , AppleSingle , AppleDouble |
MessageBodyFormat | Write | String | The MessageBodyFormat parameter specifies the message body format for messages sent to the mail contact or mail user. Valid values are: Text, Html, TextAndHtml | Text , Html , TextAndHtml |
MessageFormat | Write | String | The MessageFormat parameter specifies the message format for messages sent to the mail contact or mail user. Valid values are: Mime, Text | Mime , Text |
ModeratedBy | Write | StringArray[] | The ModeratedBy parameter specifies one or more moderators for this mail contact. A moderator approves messages sent to the mail contact before the messages are delivered. A moderator must be a mailbox, mail user, or mail contact in your organization. | |
ModerationEnabled | Write | Boolean | The ModerationEnabled parameter specifies whether moderation is enabled for this recipient. | |
OrganizationalUnit | Write | String | The OrganizationalUnit parameter specifies the location in Active Directory where the new contact is created. | |
SendModerationNotifications | Write | String | The SendModerationNotifications parameter specifies when moderation notification messages are sent. Valid values are: ALways, Internal, Never | Always , Internal , Never |
UsePreferMessageFormat | Write | Boolean | The UsePreferMessageFormat specifies whether the message format settings configured for the mail user or mail contact override the global settings configured for the remote domain or configured by the message sender | |
Ensure | Write | String | Specifies if this Contact should exist. | Present , Absent |
Credential | Write | PSCredential | Credentials of the Exchange Global Admin | |
ApplicationId | Write | String | Id of the Azure Active Directory application to authenticate with. | |
TenantId | Write | String | Id of the Azure Active Directory tenant used for authentication. | |
CertificateThumbprint | Write | String | Thumbprint of the Azure Active Directory application's authentication certificate to use for authentication. | |
CertificatePassword | Write | PSCredential | Username can be made up to anything but password will be used for CertificatePassword | |
CertificatePath | Write | String | Path to certificate used in service principal usually a PFX file. | |
ManagedIdentity | Write | Boolean | Managed ID being used for authentication. |
EXOAddressList¶
Description¶
This resource configures Exchange Online address lists.
Permissions¶
Exchange¶
To authenticate with Microsoft Exchange, this resource required the following permissions:
Roles¶
- Address Lists
Role Groups¶
- None
Examples¶
Example 1¶
This example is used to test new resources and showcase the usage of new resources being worked on. It is not meant to use as a production baseline.
Configuration Example
{
param(
[Parameter(Mandatory = $true)]
[PSCredential]
$credsCredential
)
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{
EXOMailContact 'TestMailContact'
{
Alias = "TestMailContact";
Credential = $Credscredential;
DisplayName = "My Test Contact";
Ensure = "Present";
ExternalEmailAddress = "SMTP:test@tailspintoys.com";
MacAttachmentFormat = "BinHex";
MessageBodyFormat = "TextAndHtml";
MessageFormat = "Mime";
ModeratedBy = @();
ModerationEnabled = $False;
Name = "My Test Contact";
OrganizationalUnit = "nampr03a010.prod.outlook.com/Microsoft Exchange Hosted Organizations/$OrganizationName";
SendModerationNotifications = "Always";
UsePreferMessageFormat = $True;
}
}
}