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

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