Applies to: Exchange Server 2007
Topic Last Modified: 2007-08-29
This topic explains how to use the Start-ClusteredMailboxServer cmdlet to start a Microsoft Exchange Server 2007 clustered mailbox server after it was shut down with a Stop-ClusteredMailboxServer cmdlet or to restart a failed clustered mailbox server after the problem has been corrected.
Syntax
start-ClusteredMailboxServer -Identity
<MailboxServerIdParameter> [-DomainController
<Fqdn>]
|
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.MailboxServerIdParameter |
The Identity parameter specifies the name or GUID of the clustered mailbox server to be started. |
Confirm |
Optional |
System.Boolean |
The Confirm parameter causes the command to pause processing and requires the administrator to acknowledge what the command will do before processing continues. The default value is $true. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name of the domain controller to locate the CMS include the DomainController parameter on the command. |
WhatIf |
Optional |
System.Boolean |
The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, the administrator can view what changes would occur without having to apply any of those changes. The default value is $false. |
Detailed Description
An Exchange administrator may occasionally need to start or stop a clustered mailbox server due to issues such as installing an Exchange software update or a facility failure in the datacenter. In this case, the administrator does not want to activate a passive server by using the Move-ClusteredMailboxServer cmdlet, but rather shut down all clustered mailbox server operations. The Stop-ClusteredMailboxServer cmdlet allows the Exchange administrator to shut down the server in a clean state and leave it shut down. Unlike the Move-ClusteredMailboxServer cmdlet or an automatic failover, after issuing a Stop-ClusteredMailboxServer command, a restart of the operating system will not bring Exchange back online. To activate the server after issuing a Stop-ClusteredMailboxServer command, the administrator must issue an explicit Start-ClusteredMailboxServer command.
To successfully initiate a Start-ClusteredMailboxServer operation, the following conditions must be met:
- A clustered mailbox server must not be running on a node.
- The cluster must be formed and accessible.
- The data for the clustered mailbox server must be available and
operational.
Important: The completion of the Start-ClusteredMailboxServer operation does not mean that all mailbox functionality for the server is online. The administrator must review the information contained in the completion report to determine if the server came online completely or only partially. This task does not complete until a terminal state is reached for the server. That terminal state may or may not be online.
The Start-ClusteredMailboxServer cmdlet can be run remotely from an administrative workstation.
To learn more about the Stop-ClusteredMailboxServer cmdlet, see Stop-ClusteredMailboxServer (RTM).
This task requires that the account you use to initiate the task is delegated the Exchange Server Administrator role and local Administrators group for the target server. For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.
Errors
Error | Description |
---|---|
|
The task was unable to connect to the cluster due to a communication issue, or the cluster is not available. This may be because the node is unavailable, or the node is available and the cluster is unavailable, or because the computer being used cannot access a node or computer. |
|
The Start-ClusteredMailboxServer command is supported on Exchange 2007 only and <ServerName> is not an Exchange 2007 server. |
|
User does not have Exchange Server Administrator authority on the specified server. |
|
The server is a stand-alone Mailbox server. |
|
Unable to perform the requested operation on the specified clustered mailbox server because the server does not exist. Specified server: <ServerName>. |
|
Unable to perform the requested operation on the specified clustered mailbox server because the specified server is not a clustered mailbox server. Specified server: <ServerName>. |
Example
The following code example shows how to start the Mailbox server named ClusteredMailboxServer1.
Copy Code | |
---|---|
Start-ClusteredMailboxServer -Identity:ClusteredMailboxServer1 |