Командлет Remove-DistributionGroup используется для удаления существующей группы рассылки из службы каталогов Active Directory.

Синтаксис

Remove-DistributionGroup -Identity <DistributionGroupIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

Параметр Identity задает группу рассылки, которую требуется удалить. Параметр Identity может принимать любое из следующих значений для группы рассылки:

  • различающееся имя (DN)

  • каноническое имя

  • идентификатор GUID

  • имя

  • краткое имя

  • псевдоним

  • DN из прежних версий Exchange

  • Первичный SMTP-адрес

Confirm

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

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя контроллера домена, записывающего это изменение конфигурации в Active Directory, включите параметр DomainController.

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

Параметр IgnoreDefaultScope указывает, что при выполнении команды параметр, определяющий область получателя по умолчанию для командной консоли Exchange, должен пропускаться, и задает в качестве области весь лес. Это обеспечивает команде доступ к объектам Active Directory, которые в текущий момент не относятся к области по умолчанию. При использовании параметра IgnoreDefaultScope действуют ограничения, описанные ниже.

  • Нельзя использовать параметр DomainController. Команда будет использовать подходящий сервер глобального каталога автоматически.

  • В качестве значения параметра Identity можно использовать только различающееся имя. Другие формы идентификации, например с помощью псевдонима или идентификатора GUID, не допускаются.

WhatIf

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

System.Management.Automation.SwitchParameter

При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется.

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

Командлет Remove-DistributionGroup удаляет существующую группу рассылки из службы каталогов Active Directory.

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

  • роль администратора получателей Exchange;

  • роль оператора учета для соответствующих контейнеров Active Directory.

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

В следующем примере кода показано, как использовать командлет Remove-DistributionGroup для удаления существующей группы рассылки с именем «Temporary Staff».

Копировать код
Remove-DistributionGroup -Identity "Temporary Staff"