New-MailContact cmdlet creates a new company's mail contact in HostPilotĀ® Control Panel.

This cmdlet supports risk-mitigation parameters.


Mandatory (R/O)

DescriptionRestrictions/Valid Values
1 Authentication Information (all parameters)  
2 DisplayName string R

Name of the mail contact in the list of HostPilot

Max length is 256 symbols

3 EmailAddress string R Contact's external Email address (e.g. ) Valid address

Output parameters

When the new mail contact is created, the object with the properties, described below, returns. Properties with values are:

  • DisplayName
  • DistinguishedName
  • EmailAddress
  • GUID
  • HideFromAddressBook
  • OriginatingServer

The other properties return empty and can be filled and updated later (e.g. see Set-MailContact cmdlet).

PropertyTypeDescriptionValid Values


1 City string Company information (CI): City  
2 Company string CI: Name  
3 Country string CI: Country  
4 Department string CI: Department of the company, where the contact works  
5 DisplayName string Name of the mail contact   in the list of HostPilot  
6 DistinguishedName string Unique name of the object (mail contact) in Active Directory  
7 EmailAddress string Contact's external E mail address (e.g. )  
8 FaxPhoneNumber string CI: Fax number  
9 FirstName string  First name of the contact  
10 GUID string Globally Unique Identifier (ObjectGuid)  
11 HideFromAddressBook bool The property specifies whether this contact is visible in the address book
  • True the contact is excluded from the address book, when the search is performed.
  • False - the contact is visible in the address book. This is the default value.

12 HomePhoneNumber string Contact's home phone number  
13 Initials string  Initials  of the contact  
14 LastName  string  Last name of the contact  
15 MobilePhoneNumber string  Contact's mobile phone number  
16 Notes string Additional information, comments  
17 Office string CI: Special attribute of the office (e.g. location)  
18 OrganizationalUnit string Unit inside of the account. These units are used for separating access rights to different user's groups  
19 OriginatingServer string Address of the server (domain name), where  the object physically exists  
20 Pager string

Contact's pager number

21 PhoneNumber string  CI: Contact's business phone  
22 PostalCode string  CI: PostalCode (ZIP)  
23 State string  CI: Name of the state  
24 StreetAddress string  CI: Address (street)  
25 Title string 

CI: Contact's job title


26 WWWHomePage string  CI: Web page of the contact's company


Example of using New-MailContact cmdlet 

New-MailContact -Displayname "My Contact" -EmailAddress ""