Get-StorageGroup

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2007-07-05

Командлет Get-StorageGroup используется для извлечения объекта группы хранения из службы каталогов Active Directory.

Синтаксис

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

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

Подробное описание

Для выполнения командлета Get-StorageGroup используемой учетной записи необходимо делегировать следующую роль:

  • роль администратора Exchange с правами на просмотр.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

Параметр Обязательный Тип Описание

Server

Обязательный

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Параметр Server задает имя сервера, на котором запрашиваются группы хранения. Этот параметр может использоваться вместо параметра Identity, если для сервера требуется извлечь все объекты групп хранения.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя (FQDN) контроллера домена, который извлекает данные из службы каталогов Active Directory, включите в команду параметр DomainController. Из-за задержек в репликации Active Directory разные серверы Active Directory могут возвращать разные значения, если новая группа хранения была создана недавно.

Identity

Необязательный

Microsoft.Exchange.Configuration.Tasks.StorageGroupIdParameter

С помощью параметра Identity можно задать GUID или различающееся имя, которые представляют определенную группу хранения. Можно также включить имя сервера в формате «имя_сервера\группа_хранения». Метка параметра «Identity» является необязательной.

IncludePreExchange2007

Необязательный

System.Management.Automation.SwitchParameter

Если значение параметра IncludeExchange2003Servers равно $true, этот параметр возвращает сведения о предыдущих версиях Exchange помимо Exchange Server 2007.

Status

Необязательный

System.Management.Automation.SwitchParameter

Параметр Status используется для вывода трех свойств группы хранения, связанных с локальной непрерывной репликацией или кластером с непрерывной репликацией:

  • CanEnableLocalCopy

  • CanRunDefaultUpdate

  • CanRunRestore

Свойства состояния могут принимать следующие значения:

  • CanEnableLocalCopy

  • Invalid

  • CanBeEnabled

  • DatabaseEnabled

  • AlreadyEnabled

  • CanRunDefaultUpdate

  • Invalid

  • NotLocal

  • NotSuspended

  • Allowed

  • CanRunRestore

  • Invalid

  • NotLocal

  • Allowed

Дополнительные сведения об использовании параметра Status см. в подразделе «Пример» далее в этом разделе.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

  

 

Исключения

Исключения Описание

 

 

Пример

Первый образец кода является примером использования команды Get-StorageGroup. В этом примере выходные данные команды Get-StorageGroup направляются на вход команды Format-List, чтобы в результатах отображались все доступные сведения.

Второй образец кода является примером использования параметра Status.

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