New-StorageGroup
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
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>]]
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.
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 |
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 |
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:
|
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 |
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.)
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