Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2007-08-24

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

Syntax

New-StorageGroup -Name <String> [-CircularLoggingEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-CopyLogFolderPath <NonRootLocalLongFullPath>] [-CopySystemFolderPath <NonRootLocalLongFullPath>] [-DomainController <Fqdn>] [-HasLocalCopy <$true | $false>] [-LogFolderPath <NonRootLocalLongFullPath>] [-ReplayLagTime <Nullable>] [-Server <ServerIdParameter>] [-StandbyMachine <String>] [-SystemFolderPath <NonRootLocalLongFullPath>] [-TemplateInstance <PSObject>] [-TruncationLagTime <Nullable>] [-WhatIf [<SwitchParameter>]] [-ZeroDatabasePages <$true | $false>]
New-StorageGroup [-Name <String>] -Recovery <SwitchParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LogFolderPath <NonRootLocalLongFullPath>] [-Server <ServerIdParameter>] [-SystemFolderPath <NonRootLocalLongFullPath>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

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.

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.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You do not have to specify a value with the Confirm parameter.

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 has 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>.

ReplayLagTime

Optional

System.Nullable

When SCR is configured for a storage group, you can use the ReplayLagtime parameter to specify the amount of time that the Microsoft Exchange Replication Service should wait before replaying log files that have been copied to the SCR target computer. The format for this parameter is (Days.Hours:Minutes:Seconds). The default setting for this value is 24 hours. The maximum allowable setting for this value is 7 days. The minimum allowable setting is 0 seconds, although setting this value to 0 seconds will not affect the default delay in log replay activity of 50 log files.

ReplayLagtime can be specified only when StandbyMachine is specified.

Server

Optional

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.

StandbyMachine

Optional

System.String

The StandbyMachine parameter specifies the server where the SCR copy is located. The standby computer must have the Mailbox role installed and must not be part of a cluster with a configured clustered mailbox server.

Valid values for StandbyMachine are:

  • FQDN

  • Server name

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.

TruncationLagTime

Optional

System.Nullable

The TruncationLagTime parameter is used to specify the amount of time that the Microsoft Exchange Replication Service should wait before truncating log files that have been copied to the SCR target computer and replayed into the copy of the database. The time period begins after the log has been successfully replayed into the copy of the database. The format for this parameter is (Days.Hours:Minutes:Seconds). The maximum allowable setting for this value is 7 days. The minimum allowable setting is 0 seconds, although setting this value to 0 seconds effectively eliminates any delay in log truncation activity.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You do not have to specify a value with the WhatIf parameter.

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 2007, see Permission Considerations

For more information about standby continuous replication (SCR), see Managing Standby Continuous Replication.

Input Types

Return Types

Errors

Error Description

 

Exceptions

Exceptions Description

Example

In the first example, the New-StorageGroup command is used to create a new storage group.

In the second example, a new storage group is created on a server on which SCR is configured.

In the third example, the Get-StorageGroup command is used to view the information about the storage group that was created in the second example.

Note:
You cannot view lag time directly with the Get-StorageGroup command. StandbyMachines is a multiparameter attribute, and you must to look at the attributes to see the lag time. (For more information, see the commands and results following the third example.)
Copy Code
New-StorageGroup -Name MyNewStorageGroup -Server ExchangeServer1 -LogFolderPath:"D:\Mailbox\First Storage Group" -SystemFolderPath:"D:\Mailbox\First Storage Group"

New-StorageGroup -Server: 'ExSrvr1' -Name: 'SG9' -LogFolderPath: 'C:\SG9' -SystemFolderPath: 'C:\SG9' -StandbyMachine ExSrvr2 -ReplayLagTime 0.06:00:00 -TruncationLagTime 1.00:00:00

Get-StorageGroup ExSrvr1\SG9 | fl Name,Standbymachines
Name: SG9 StandbyMachines: {ExSrvr2.fabrikam.com}

$sg=Get-StorageGroup ExSrvr1\SG9
$sg.StandbyMachines

NodeNameVersionReplayLagTimeTruncationLagTime
-----------------------------------------
ExSrvr2...106:00:001.00:00:00