New-StorageGroup (RTM)

Article
01/23/2017

Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.

Applies to: Exchange Server 2007

Use the New-StorageGroup cmdlet to create a storage group on the specified server.

Syntax

New-StorageGroup -Name <String> -Server <ServerIdParameter> [-CircularLoggingEnabled <$true | $false>] [-CopyLogFolderPath <NonRootLocalLongFullPath>] [-CopySystemFolderPath <NonRootLocalLongFullPath>] [-DomainController <Fqdn>] [-HasLocalCopy <$true | $false>] [-LogFolderPath <NonRootLocalLongFullPath>] [-SystemFolderPath <NonRootLocalLongFullPath>] [-TemplateInstance <PSObject>] [-ZeroDatabasePages <$true | $false>]

New-StorageGroup [-Name <String>] -Recovery <SwitchParameter> -Server <ServerIdParameter> [-DomainController <Fqdn>] [-LogFolderPath <NonRootLocalLongFullPath>] [-SystemFolderPath <NonRootLocalLongFullPath>] [-TemplateInstance <PSObject>]

Detailed Description

You can use the New-StorageGroup cmdlet to create a new storage group or a new recovery storage group on a Microsoft Exchange Server 2007 Mailbox server.

A storage group contains mailbox or public folder databases. The number of storage groups and databases that you can create on a server depends on the version of Exchange that you are running.

A recovery storage group enables you to recover data from a backup copy of the database without disturbing user access to current data. The recovery storage group can also be useful in retrieving data if there is data loss. A server can contain only one recovery storage group. A recovery storage group can contain only a recovery mailbox database. You cannot mount public folders to a recovery storage group.

To run the New-StorageGroup cmdlet, the account you use must be delegated the following:

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.

Parameters

Parameter	Required	Type	Description
Name	Required	System.String	The Name parameter specifies the name of the new storage group.
Recovery	Required	System.Management.Automation.SwitchParameter	The Recovery parameter specifies that the new group is designated as a recovery storage group.
Server	Required	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	The Server parameter specifies the name of the server where the storage group will be created. The server must have the Mailbox server role installed.
CircularLoggingEnabled	Optional	System.Boolean	The CircularLoggingEnabled parameter with a value of `$true` means that circular logging is enabled. The default value is `$false`. Circular logging is automatically disabled if HasLocalCopy, CopyLogFolderPath, or CopySystemFolderPath is specified.
CopyLogFolderPath	Optional	Microsoft.Exchange.Data.NonRootLocalLongFullPath	The CopyLogFolderPath parameter specifies the folder location for copies of the log files. The default path is <ExchangeInstallPath>\Mailbox\LocalCopies\<StorageGroupName>. The location must be local. Remote-access disk drives are not permissible.
CopySystemFolderPath	Optional	Microsoft.Exchange.Data.NonRootLocalLongFullPath	The CopySystemFolderPath parameter specifies the folder location for copies of the system files. The default path is <ExchangeInstallPath>\Mailbox\LocalCopies\<StorageGroupName>.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter in the command.
HasLocalCopy	Optional	System.Boolean	The HasLocalCopy parameter specifies whether the storage group has a local copy. A value of `$true` means that this storage group will have a local storage group copy. The default value is `$false` if no copy paths are provided. If at least one copy path is provided, the default is `$true`.
LogFolderPath	Optional	Microsoft.Exchange.Data.NonRootLocalLongFullPath	The LogFolderPath parameter specifies the folder location for log files. The default path is <ExchangeInstallPath>\Mailbox <StorageGroupName>.
SystemFolderPath	Optional	Microsoft.Exchange.Data.NonRootLocalLongFullPath	The SystemFolderPath parameter specifies the folder location for system files. The default path is <ExchangeInstallPath>\Mailbox <StorageGroupName>.
TemplateInstance	Optional	System.Management.Automation.PSObject	The TemplateInstance parameter specifies the template that was used to create the storage group.
ZeroDatabasePages	Optional	System.Boolean	When the ZeroDatabasePages parameter has a value of `$true`, zeroing deleted pages is enabled. The default value is `$false`.

Input Types

Return Types

Errors

Error	Description

Exceptions

Exceptions	Description

Example

The following code is an example of the New-StorageGroup command.

New-StorageGroup -Name MyNewStorageGroup -Server ExchangeServer1 -LogFolderPath:"D:\Mailbox\First Storage Group" -SystemFolderPath:"D:\Mailbox\First Storage Group"