Set-Group

Модуль:

ExchangePowerShell

Применяется к:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет Set-Group для изменения параметров объекта группы. Если группа является группой безопасности с поддержкой почты или группой рассылки, с помощью командлета Set-DistributionGroup можно изменить другие параметры exchange Майкрософт, которые недоступны с помощью командлета Set-Group.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Set-Group
   [-Identity] <GroupIdParameter>
   [-BypassSecurityGroupManagerCheck]
   [-Confirm]
   [-Description <MultiValueProperty>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-IgnoreDefaultScope]
   [-IsHierarchicalGroup <Boolean>]
   [-ManagedBy <GeneralRecipientIdParameter[]>]
   [-Name <String>]
   [-Notes <String>]
   [-PhoneticDisplayName <String>]
   [-SeniorityIndex <Int32>]
   [-SimpleDisplayName <String>]
   [-Universal]
   [-WhatIf]
   [-WindowsEmailAddress <SmtpAddress>]
   [<CommonParameters>]

Описание

Командлет Set-Group нельзя использовать для изменения динамических групп рассылки. Для изменения динамических групп рассылки следует использовать командлет Set-DynamicDistributionGroup.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Set-Group -Identity "Legal Department" -Universal -Notes "verified"

В этом примере к существующей глобальной группе безопасности с именем «Legal Department» применяются следующие изменения:

Изменение области действия группы на универсальную.

Добавление значения параметра Notes проверки.

Пример 2

Set-Group -Identity "Human Resources" -IsHierarchicalGroup $true -SeniorityIndex 1

В этом примере указывается, что группа «Human Resources» является иерархической и будет отображаться в своей иерархии последней, так как ее индекс равен 1.

Параметры

-BypassSecurityGroupManagerCheck

Параметр BypassSecurityGroupManagerCheck указывает, следует ли разрешить пользователю, который не является владельцем группы, изменять или удалять группу. Для этого переключателя не требуется указывать значение.

Если вы не определены в свойстве ManagedBy группы, необходимо использовать этот параметр в командах, которые изменяют или удаляют группу. Чтобы использовать этот параметр, вашей учетной записи требуются определенные разрешения в зависимости от типа группы:

• Группы рассылки или группы безопасности с поддержкой почты. Вам необходимо быть членом группы ролей "Управление организацией" или иметь назначенную роль "Создание группы безопасности" и "Членство".
• Группы рассылки или группы безопасности с поддержкой почты. Вы должны быть участником группы ролей "Управление организацией" или вам должны быть назначены роли "Создание группы безопасности" и "Членство".

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Confirm

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

• Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
• Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Description

Этот параметр доступен только в облачной службе.

{{ Описание описания заполнения }}

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-DisplayName

Параметр DisplayName указывает отображаемое имя группы. Отображаемое имя показывается в Центре администрирования Exchange и в списках адресов. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Этот параметр имеет смысл только в том случае, если в группе включена поддержка почты.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Параметр DomainController не поддерживается пограничными транспортными серверами. Пограничный транспортный сервер использует локальный экземпляр службы Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

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

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

Type:	GroupIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IgnoreDefaultScope

Этот параметр доступен только в локальной среде Exchange.

Параметр IgnoreDefaultScope указывает команде игнорировать параметр области получателя по умолчанию для сеанса Exchange PowerShell и использовать в качестве области весь лес. Указывать значение для этого параметра необязательно.

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IsHierarchicalGroup

Параметр IsHierarchicalGroup указывает, является ли группа частью иерархической адресной книги. Допустимые значения: $true или $false. Значение по умолчанию — $false.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ManagedBy

Параметр ManagedBy указывает владельца группы. У группы должно быть не менее одного владельца. Если вы не используете этот параметр, чтобы указать владельца при создании группы, ее владельцем будет учетная запись пользователя, создавшего группу. Владелец группы может:

• Параметр ManagedBy указывает владельца группы. У группы должен быть хотя бы один владелец. Если при создании группы вы не используете этот параметр для указания ее владельца, то владельцем станет учетная запись, создавшая группу. Владелец группы может выполнять указанные ниже действия.
• Изменять свойства группы.
• Добавлять и удалять участников группы.
• Удалять группу.
• Утверждать запросы на выход из группы и присоединение к ней (если таковые имеются).

Владельцем, указанным для этого параметра, должен быть почтовый ящик, почтовый пользователь или группа безопасности с поддержкой почты (субъект безопасности с поддержкой почты, которому могут быть назначены разрешения). Вы можете использовать любое значение, однозначно идентифицирующее владельца. Например:

• Имя
• Псевдоним
• различающееся имя (DN);
• различающееся имя (DN);
• Домен\Имя пользователя
• Адрес электронной почты
• GUID
• LegacyExchangeDN
• SamAccountName
• Идентификатор пользователя или имя участника-пользователя

Чтобы ввести несколько владельцев и перезаписать все существующие записи, используйте следующий синтаксис: Owner1,Owner2,...OwnerN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Owner1","Owner2",..."OwnerN".

Чтобы добавить или удалить владельцев без влияния на другие существующие записи, используйте следующий синтаксис: @{Add="Owner1","Owner2",...; Remove="Owner3","Owner4"...}.

Владельцы, указанные с помощью этого параметра, не добавляются в качестве членов группы. Необходимо вручную добавить владельцев в качестве членов.

Примечание. Управление группами в Outlook не работает, если владелец является группой безопасности с поддержкой почты. Для управления группой в Outlook владелец должен быть почтовым ящиком или пользователем почты.

Type:	GeneralRecipientIdParameter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

Параметр Name указывает уникальное имя группы. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Notes

Параметр Notes указывает дополнительные сведения об объекте. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PhoneticDisplayName

Параметр PhoneticDisplayName определяет варианты правописания имени пользователя, которые используются для преобразования текста в речь в средах единой системы обмена сообщениями. Обычно этот параметр используется в случаях, когда произношение и правописание имени пользователя не совпадают. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SeniorityIndex

Параметр SeniorityIndex указывает порядок отображения группы в иерархической адресной книге. Группа со значением 2 будет отображаться в адресной книге выше, чем группа со значением 1.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SimpleDisplayName

Параметр SimpleDisplayName используется для отображения альтернативного описания объекта, если разрешен только ограниченный набор символов. Допустимые символы:

• Параметр SimpleDisplayName используется для отображения альтернативного описания объекта, если разрешен только ограниченный набор символов. Допустимые символы:
• a–z
• A–Z
• Пробел
• " ' ( ) + , - . / : ?

Этот параметр имеет смысл только в том случае, если в группе включена поддержка почты.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Universal

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WindowsEmailAddress

Параметр WindowsEmailAddress указывает адрес электронной почты Windows для этого получателя. Это общий атрибут Active Directory, который присутствует во всех средах, включая среды без Exchange. Использование параметра WindowsEmailAddress для получателя приводит к одному из следующих результатов:

• В средах, где получатель подчиняется политикам адресов электронной почты (свойство EmailAddressPolicyEnabled имеет значение True для получателя), параметр WindowsEmailAddress не влияет на свойство WindowsEmailAddress или основное значение адреса электронной почты.
• В средах, где получатель не подчиняется политикам адресов электронной почты (свойству EmailAddressPolicyEnabled задано значение False для получателя), параметр WindowsEmailAddress обновляет свойство WindowsEmailAddress и основной адрес электронной почты на то же значение.

Свойство WindowsEmailAddress отображается для получателя в Пользователи и компьютеры Active Directory в атрибуте E-mail. Общее имя атрибута — E-mail-Addresses, а ldap-Display-Name — mail. При изменении этого атрибута в Active Directory основной адрес электронной почты получателя не будет обновлен до того же значения.

Type:	SmtpAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.