Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-05
Use the Get-StorageGroup cmdlet to retrieve a storage group object from the Active Directory directory service.
Syntax
Get-StorageGroup [-Identity
<StorageGroupIdParameter>] [-DomainController
<Fqdn>]
|
Get-StorageGroup -Server <ServerIdParameter>
[-DomainController <Fqdn>]
|
Get-StorageGroup -IncludePreExchange2007
<SwitchParameter> [-DomainController <Fqdn>]
|
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
IncludePreExchange2007 |
Required |
System.Management.Automation.SwitchParameter |
If the value of the IncludeExchange2003Servers parameter
is |
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. |
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 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 Get-StorageGroup command. In this 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.
Copy Code | |
---|---|
Get-StorageGroup -Identity "Storage Group Server\First Storage Group" | Format-List |