Get-StorageGroup

  • Article

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the Get-StorageGroup cmdlet to retrieve a storage group object from the Active Directory directory service.

Syntax

Get-StorageGroup [-Identity <StorageGroupIdParameter>] [-DomainController <Fqdn>] [-IncludePreExchange2007 <SwitchParameter>] [-Status <SwitchParameter>]

Get-StorageGroup -Server <ServerIdParameter> [-DomainController <Fqdn>] [-IncludePreExchange2007 <SwitchParameter>] [-Status <SwitchParameter>]

Detailed Description

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

  • Exchange View-Only Administrator role

For more information about permissions, delegating roles, and the rights that are required to administer Microsoft Exchange Server 2007, see Permission Considerations.

Parameters

Parameter Required Type Description

Server

Required

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

The Server parameter specifies the name of the server to query for storage groups. This parameter can be used instead of the Identity parameter if you want to retrieve all storage group objects for the server.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory, include the DomainController parameter in the command. Because of delays in Active Directory replication, different Active Directory servers might return different values if a new storage group was created recently.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.StorageGroupIdParameter

Use the Identity parameter to specify the GUID or distinguished name that represents a specific storage group. You can also include the server name using the format ServerName\StorageGroup. The "Identity" parameter label is optional.

IncludePreExchange2007

Optional

System.Management.Automation.SwitchParameter

If the value of the IncludeExchange2003Servers parameter is $true, this parameter returns information about previous versions of Exchange in addition to Exchange Server 2007.

Status

Optional

System.Management.Automation.SwitchParameter

Use the Status parameter to display three storage group properties relating to LCR or CCR:

  • CanEnableLocalCopy

  • CanRunDefaultUpdate

  • CanRunRestore

The status properties can have the following values:

  • CanEnableLocalCopy

  • Invalid

  • CanBeEnabled

  • DatabaseEnabled

  • AlreadyEnabled

  • CanRunDefaultUpdate

  • Invalid

  • NotLocal

  • NotSuspended

  • Allowed

  • CanRunRestore

  • Invalid

  • NotLocal

  • Allowed

For information about how to use the Status parameter, see "Example" later in this topic.

Input Types

Return Types

Errors

Error Description

  

 

Exceptions

Exceptions Description

 

 

Example

The first code sample is an example of the Get-StorageGroup command. In the example, the output of the Get-StorageGroup command is piped to the Format-List command so that all the available information is displayed in the result.

The second code sample demonstrates the use of the Status parameter.

Get-StorageGroup -Identity "Storage Group Server\First Storage Group" | Format-List
Get-StorageGroup -Status | FT -Autosize Name, CanEnableLocalCopy, CanRunRestore, CanRunDefaultUpdate