Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-05

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>]

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.

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.

Input Types

Return Types

Errors

Error Description

 

Exceptions

Exceptions Description

Example

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

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