Hosted Email 2007::DeleteSMTPDomainByGUID
This procedure must perform the following actions:
Delete SMTP asset associated with the organization which is specified by GUID. The organization instance is assumed to have been deleted from Active Directory.
Delete SMTP domain from Exchange server.
Arguments
Input Arguments | Required | Type | Description |
---|---|---|---|
<GUID> |
Yes |
string |
The GUID of the organization with SMTP Domain. |
<domainName> |
Yes |
string |
This parameter specifies a unique SMTP domain name for the accepted domain object. If this parameter is not supplied, SMTP domain retrieved from assets of the organization will be deleted. |
<preferredDomainController> |
Yes |
string |
The domain controller to use for Active Directory operations. Use the fully qualified domain name (FQDN) of the domain controller. |
Output Arguments | Type | Description |
---|---|---|
<DomainName> |
string |
The name of the deleted SMTP domain. |
Remarks
Security
As an additional safeguard against improper modification against a live tenant an attempt should be made to bind to the supplied GUID in Active Directory. If the Active Directory object referenced by GUID exists, the procedure should fail.
Error Handling
Error Condition | Error Text |
---|---|
Active Directory object referenced by GUID exists. |
The object with GUID %GUID% was found in Active Directory. This procedure should only be used when the corresponding Active Directory object has been deleted. |
Sample Code
Example XML Request
Applies To
- Hosted Messaging and Collaboration version 4.5