Командлет Remove-DistributionGroup используется для удаления существующей группы рассылки из службы каталогов Active Directory.
Синтаксис
Remove-DistributionGroup -Identity <DistributionGroupIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]] |
Параметры
Параметр | Обязательный | Тип | Описание |
---|---|---|---|
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter |
Параметр Identity задает группу рассылки, которую требуется удалить. Параметр Identity может принимать любое из следующих значений для группы рассылки:
|
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 действуют ограничения, описанные ниже.
|
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" |