Partager via

ExchangeUtils.CreateMailbox Method (ConnectedMA, ReferenceValue, String, String, Int64, Int64, Int64, Byte[], Boolean)

  • Article

Creates a mailbox in Microsoft Exchange Server 2000 or Exchange Server 2003 that has certain properties, depending on which arguments are supplied.

Namespace: Microsoft.MetadirectoryServices
Assembly: Microsoft.MetadirectoryServicesEx (in Microsoft.MetadirectoryServicesEx.dll)

Usage

'Usage
Dim TargetADMA As ConnectedMA
Dim DistinguishedName As ReferenceValue
Dim Alias As String
Dim HomeMDB As String
Dim StoreQuota As Long
Dim OverQuotaLimit As Long
Dim HardLimit As Long
Dim LogonAccountSID As Byte()
Dim Exchange2003InetOrgPerson As Boolean
Dim returnValue As CSEntry

returnValue = ExchangeUtils.CreateMailbox(TargetADMA, DistinguishedName, Alias, HomeMDB, StoreQuota, OverQuotaLimit, HardLimit, LogonAccountSID, Exchange2003InetOrgPerson)

Syntax

'Declaration
Public Shared Function CreateMailbox ( _
    TargetADMA As ConnectedMA, _
    DistinguishedName As ReferenceValue, _
    Alias As String, _
    HomeMDB As String, _
    StoreQuota As Long, _
    OverQuotaLimit As Long, _
    HardLimit As Long, _
    LogonAccountSID As Byte(), _
    Exchange2003InetOrgPerson As Boolean _
) As CSEntry

public static CSEntry CreateMailbox (
    ConnectedMA TargetADMA,
    ReferenceValue DistinguishedName,
    string Alias,
    string HomeMDB,
    long StoreQuota,
    long OverQuotaLimit,
    long HardLimit,
    byte[] LogonAccountSID,
    bool Exchange2003InetOrgPerson
)

public:
static CSEntry^ CreateMailbox (
    ConnectedMA^ TargetADMA, 
    ReferenceValue^ DistinguishedName, 
    String^ Alias, 
    String^ HomeMDB, 
    long long StoreQuota, 
    long long OverQuotaLimit, 
    long long HardLimit, 
    array<unsigned char>^ LogonAccountSID, 
    bool Exchange2003InetOrgPerson
)

public static CSEntry CreateMailbox (
    ConnectedMA TargetADMA, 
    ReferenceValue DistinguishedName, 
    String Alias, 
    String HomeMDB, 
    long StoreQuota, 
    long OverQuotaLimit, 
    long HardLimit, 
    byte[] LogonAccountSID, 
    boolean Exchange2003InetOrgPerson
)

public static function CreateMailbox (
    TargetADMA : ConnectedMA, 
    DistinguishedName : ReferenceValue, 
    Alias : String, 
    HomeMDB : String, 
    StoreQuota : long, 
    OverQuotaLimit : long, 
    HardLimit : long, 
    LogonAccountSID : byte[], 
    Exchange2003InetOrgPerson : boolean
) : CSEntry

Parameters

  • TargetADMA
    The Active Directory management agent through which the new object is provisioned.
  • DistinguishedName
    The distinguished name of the mailbox.
  • Alias
    The e-mail alias of the mailbox.
  • HomeMDB
    The location of the mailbox store.
  • StoreQuota
    The limit, in kilobytes, to the amount of disk space that the user can use to store e-mail messages. If this quota is exceeded, the user receives a warning message.
  • OverQuotaLimit
    The additional disk space, in kilobytes, that the user can use to store e-mail messages. If this quota is exceeded, the user cannot send e-mail but can receive e-mail.
  • HardLimit
    The additional disk space, in kilobytes, that the user can use to store e-mail messages. If this quota is exceeded, the user can neither send e-mail nor receive e-mail.
  • LogonAccountSID
    The security identifier for the account.
  • Exchange2003InetOrgPerson
    Whether the account is an Exchange 2003 Internet account.

Return Value

Returns a CSEntry object that represents the connected data source entry.

Exceptions

Exception type Condition
System.ArgumentException

A required parameter is not present.
System.ArgumentNullException

A required parameter is null.
System.ArgumentOutOfRangeException

A limit is too large or too small.
AttributeNotInInclusionListException

A required attribute is not selected in the management agent.
System.InvalidOperationException

You tried to create the same custom recipient more than once in the Provision method. This method is called for each metaverse object when a metaverse rules extension exists.
NoSuchObjectTypeException

The object type that is referenced is not in the schema.

Remarks

To use the default mailbox limits, set StoreQuota, OverQuotaLimit, and HardLimit to 0 (zero).

You can create the following Exchange objects using this method.

Object Method call

Exchange 2000 or Exchange 2003 mailbox

CreateMailbox(TargetADMA, DistinguishedName, Alias, HomeMDB, 0, 0, 0, null, false)

Exchange 2000 or Exchange 2003 mailbox with limits

CreateMailbox(TargetADMA, DistinguishedName, Alias, HomeMDB, StoreQuota, OverQuotaLimit, HardLimit, null, false)

Exchange 2000 or Exchange 2003 resource mailbox

CreateMailbox(TargetADMA, DistinguishedName, Alias, HomeMDB, 0, 0, 0, LogonAccountSID, false)

Exchange 2000 or Exchange 2003 resource mailbox with limits

CreateMailbox(TargetADMA, DistinguishedName, Alias, HomeMDB, StoreQuota, OverQuotaLimit, HardLimit, LogonAccountSID, false)

Exchange 2003 InetOrgPerson with limits

CreateMailbox(TargetADMA, DistinguishedName, Alias, HomeMDB, StoreQuota, OverQuotaLimit, HardLimit, LogonAccountSID, true)

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Target Platforms

See Also

Reference

ExchangeUtils Class
ExchangeUtils Members
Microsoft.MetadirectoryServices Namespace
CSEntry Class
ExchangeUtils Class