New-UnifiedGroup

Модуль:

ExchangePowerShell

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

Exchange Online, Exchange Online Protection

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

Используйте командлет New-UnifiedGroup для создания Группы Microsoft 365 в облачной организации. Чтобы добавить участников, владельцев и подписчиков в Группы Microsoft 365, используйте командлет Add-UnifiedGroupLinks.

Примечание. Этот командлет нельзя использовать для создания Группы Microsoft 365 при подключении с использованием проверки подлинности на основе сертификата (также известной как CBA или проверка подлинности только для приложений для автоматических сценариев) или управляемого удостоверения Azure. Вместо этого вы можете использовать Microsoft Graph. Дополнительные сведения см. в разделе Создание группы.

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

Синтаксис

New-UnifiedGroup
   [-DisplayName <String>]
   [-AccessType <ModernGroupTypeInfo>]
   [-MailboxRegion <String>]
   [-Alias <String>]
   [-AlwaysSubscribeMembersToCalendarEvents]
   [-AutoSubscribeNewMembers]
   [-Classification <String>]
   [-Confirm]
   [-DataEncryptionPolicy <DataEncryptionPolicyIdParameter>]
   [-EmailAddresses <ProxyAddressCollection>]
   [-ExecutingUser <RecipientIdParameter>]
   [-ExoErrorAsWarning]
   [-HiddenGroupMembershipEnabled]
   [-IsMemberAllowedToEditContent <System.Boolean>]
   [-Language <CultureInfo>]
   [-ManagedBy <RecipientIdParameter[]>]
   [-Members <RecipientIdParameter[]>]
   [-Name <String>]
   [-Notes <String>]
   [-Owner <RecipientIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RequireSenderAuthenticationEnabled <Boolean>]
   [-SensitivityLabelId <Sustem.Guid>]
   [-SuppressWarmupMessage]
   [-WhatIf]
   [<CommonParameters>]

New-UnifiedGroup
   [-DisplayName <String>]
   [-AccessType <ModernGroupTypeInfo>]
   [-Alias <String>]
   [-AlwaysSubscribeMembersToCalendarEvents]
   [-AutoSubscribeNewMembers]
   [-Classification <String>]
   [-Confirm]
   [-DataEncryptionPolicy <DataEncryptionPolicyIdParameter>]
   [-EmailAddresses <ProxyAddressCollection>]
   [-ExecutingUser <RecipientIdParameter>]
   [-ExoErrorAsWarning]
   [-HiddenGroupMembershipEnabled]
   [-Language <CultureInfo>]
   [-ManagedBy <RecipientIdParameter[]>]
   [-Members <RecipientIdParameter[]>]
   [-Name <String>]
   [-Notes <String>]
   [-Owner <RecipientIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RequireSenderAuthenticationEnabled <Boolean>]
   [-SensitivityLabelId <Sustem.Guid>]
   [-SuppressWarmupMessage]
   [-WhatIf]
   [<CommonParameters>]

New-UnifiedGroup
   [-DisplayName <String>]
   [-SubscriptionEnabled]
   [-AccessType <ModernGroupTypeInfo>]
   [-Alias <String>]
   [-AlwaysSubscribeMembersToCalendarEvents]
   [-AutoSubscribeNewMembers]
   [-Classification <String>]
   [-Confirm]
   [-DataEncryptionPolicy <DataEncryptionPolicyIdParameter>]
   [-EmailAddresses <ProxyAddressCollection>]
   [-ExecutingUser <RecipientIdParameter>]
   [-ExoErrorAsWarning]
   [-HiddenGroupMembershipEnabled]
   [-Language <CultureInfo>]
   [-ManagedBy <RecipientIdParameter[]>]
   [-Members <RecipientIdParameter[]>]
   [-Name <String>]
   [-Notes <String>]
   [-Owner <RecipientIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RequireSenderAuthenticationEnabled <Boolean>]
   [-SensitivityLabelId <Sustem.Guid>]
   [-SuppressWarmupMessage]
   [-WhatIf]
   [<CommonParameters>]

New-UnifiedGroup
   -DlIdentity <DistributionGroupIdParameter>
   [-ConvertClosedDlToPrivateGroup]
   [-DeleteDlAfterMigration]
   [-Confirm]
   [-ExecutingUser <RecipientIdParameter>]
   [-ManagedBy <RecipientIdParameter[]>]
   [-Members <RecipientIdParameter[]>]
   [-Owner <RecipientIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Группы Microsoft 365 — это объекты групп, доступные в службах Microsoft 365.

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

Примеры

Пример 1

New-UnifiedGroup -DisplayName "Engineering Department" -Alias "engineering"

В этом примере создается группа Microsoft 365 с именем Engineering Department.

Параметры

-AccessType

Параметр AccessType указывает тип конфиденциальности для группы Microsoft 365. Допустимые значения:

• Общедоступная. Содержимое группы и беседы доступны всем пользователям, и любой пользователь может присоединиться к группе без одобрения со стороны владельца группы. Это значение используется по умолчанию.
• Частный. Содержимое группы и беседы доступны только участникам группы, и присоединение к группе требует утверждения от владельца группы.

Тип конфиденциальности можно изменить в любой момент в жизненном цикле группы.

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

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

-Alias

Параметр Alias указывает псевдоним Exchange (также называемый почтовым псевдонимом) для группы Microsoft 365. Это значение идентифицирует получателя как объект, поддерживающий почту. Не следует путать его с несколькими электронными адресами для одного и того же получателя (также называемыми прокси-адресами). У получателя может быть только одно значение Alias. Максимальная длина: 64 символа.

Значение Alias может содержать буквы, цифры и следующие символы:

• !, #, %, *, +, -, /, =, ?, ^, _, и ~.
• $, &, ', ', {, }и | должны быть экранированы (например -Alias what`'snew, ) или все значение заключено в одинарные кавычки (например, -Alias 'what'snew'). Символ & не поддерживается в значении Псевдоним для синхронизации Azure AD Connect.
• Точки (.) должны быть окружены другими допустимыми символами (например, help.desk).
• Символы Юникода от U+00A1 до U+00FF.

Если параметр Alias не используется при создании группы Microsoft 365, значение параметра DisplayName будет использоваться для значения Alias. Пробелы удаляются, неподдерживаемые символы преобразуются в вопросительные знаки (?), а для обеспечения уникальности значения Alias могут добавляться цифры.

При создании группы Microsoft 365 без использования параметра EmailAddresses значение Псевдоним используется для создания основного адреса электронной почты (alias@domain). Поддерживаемые символы Юникода сопоставляются с наиболее подходящими текстовыми символами US-ASCII. Например, U+00F6 (ö) изменяется на oe в основном адресе электронной почты.

Значение Alias добавляется к значению свойства ExternalDirectoryObjectId и используется в качестве значения свойства Name для группы Microsoft 365 (<Alias>_<ExternalDirectoryObjectId>).

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

-AlwaysSubscribeMembersToCalendarEvents

Параметр AlwaysSubscribeMembersToCalendarEvents управляет параметрами подписки по умолчанию для новых участников, добавленных в группу Microsoft 365.

• Если использовать этот параметр без значения, для подписок всех членов, добавляемых в группу, устанавливается значение ReplyAndEvents.
• Если вы используете следующий синтаксис: -AlwaysSubscribeMembersToCalendarEvents:$false, для всех будущих участников, добавленных в группу, будет задано значение ReplyOnly.

Члены группы могут изменять свои параметры подписки, переопределяя этот параметр.

Параметр AutoSubscribeNewMembers переопределяет этот параметр.

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

-AutoSubscribeNewMembers

Параметр AutoSubscribeNewMembers указывает, следует ли автоматически подписывать новых участников, добавленных в группу Microsoft 365, на беседы и события календаря. Указывать значение для этого параметра необязательно.

Этот параметр необходимо использовать вместе с параметром SubscriptionEnabled.

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

-Classification

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 Online, Exchange Online Protection

-ConvertClosedDlToPrivateGroup

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

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

Если группа рассылки имеет значение Закрыто для параметров MemberDepartRestriction или MemberJoinRestriction, группа рассылки всегда будет перенесена в частную группу Microsoft 365. Для открытых групп рассылки перенесенная группа Microsoft 365 всегда является общедоступной, а не частной.

Этот параметр можно использовать только с параметром DlIdentity.

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

-DataEncryptionPolicy

Параметр DataEncryptionPolicy указывает политику шифрования данных, которая применяется к группе Microsoft 365. Вы можете использовать любое уникальное значение, определяющее политику. Например:

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

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

-DeleteDlAfterMigration

Параметр DeleteDlAfterMigration указывает, следует ли удалять группу рассылки после ее миграции в группу Microsoft 365. Указывать значение для этого параметра необязательно.

Этот параметр можно использовать только с параметром DlIdentity.

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

-DisplayName

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

Для Группы Microsoft 365 значение DisplayName используется в свойстве unique Name. Однако, поскольку значение DisplayName не обязательно должно быть уникальным, значение DisplayName добавляется с символом подчеркивания (_) и коротким значением GUID, если оно используется для свойства Name.

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

-DlIdentity

Параметр DlIdentity указывает группу рассылки (также известную как список рассылки или DL), которую необходимо перенести в группу Microsoft 365. Группа рассылки должна быть универсальной группой рассылки (свойство RecipientTypeDetails со значением MailUniversalDistributionGroup). Можно использовать любое уникальное значение, идентифицирующее группу рассылки. Например:

• Имя
• Псевдоним
• различающееся имя (DN);
• различающееся имя (DN);
• Каноническое краткое имя
• GUID

Все свойства и членство в группе рассылки копируются в группу Microsoft 365.

Псевдонимы и прокси-адреса группы рассылки перемещаются в группу Microsoft 365 и заменяются в группе рассылки значениями DLMigrated_<GUID>. Исходные прокси-адреса копируются в свойство ExtensionCustomAttribute5 группы рассылки.

Группы Microsoft 365 не имеют параметров ReportToManager и ReportToOriginator, поэтому значения этих параметров не переносятся из группы рассылки в группу Microsoft 365. Группа Microsoft 365 ведет себя так, как если бы были заданы значения по умолчанию для этих параметров (ReportToManager — $false, а ReportToOriginator — $true). Другими словами, уведомления о состоянии доставки (также известные как DSN, отчеты о недоставке, недоставки или сообщения о недоставке) отправляются отправителю сообщения, а не владельцу группы Microsoft 365.

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

-EmailAddresses

Параметр EmailAddresses указывает все адреса электронной почты (прокси-адреса) для получателя, включая основной SMTP-адрес. В локальных организациях Exchange основной SMTP-адрес и другие прокси-адреса обычно задаются политиками адресов электронной почты. Однако этот параметр можно использовать для настройки других прокси-адресов для получателя. Дополнительные сведения см. в статье политики адресов Email в Exchange Server.

Допустимый синтаксис для этого параметра — "Type:EmailAddress1","Type:EmailAddress2",..."Type:EmailAddressN". Необязательное значение Типа указывает тип адреса электронной почты. Примеры допустимых значений:

• SMTP: основной SMTP-адрес. Это значение можно использовать только один раз в команде.
• SMTP. Основной SMTP-адрес. В команде это значение можно использовать только один раз.
• X400: адреса X.400 в локальной среде Exchange.
• X500: адреса X.500 в локальной среде Exchange.

Если не включить значение Type для адреса электронной почты, предполагается значение SMTP. Обратите внимание, что Exchange не проверяет синтаксис пользовательских типов адресов (включая адреса X.400). Поэтому необходимо убедиться, что все пользовательские адреса правильно отформатированы.

Если не включить значение для электронного адреса, то будет использовано значение smtp. Обратите внимание, что exExchangeNoVersion не проверяет синтаксис пользовательских типов адресов (включая адреса X.400). Таким образом, вам необходимо убедиться, что все пользовательские адреса имеют правильный формат.

• Используйте значение SMTP типа для адреса.
• Первый адрес электронной почты, если вы не используете значения Type или используете несколько значений типа SMTP в нижнем регистре.
• Вместо этого используйте параметр PrimarySmtpAddress. В одной команде нельзя использовать параметры EmailAddresses и PrimarySmtpAddress.

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

-ExecutingUser

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-ExoErrorAsWarning

Параметр ExoErrorAsWarning указывает, что Exchange Online ошибки, возникающие при создании группы Microsoft 365, обрабатываются как предупреждения, а не как ошибки. Указывать значение для этого параметра необязательно.

Создание Группы Microsoft 365 включает фоновые операции в Azure Active Directory и Exchange Online. Ошибки, которые могут возникнуть в Exchange Online, не препятствуют созданию группы (и поэтому на самом деле не являются ошибками), так как объект группы в Azure Active Directory синхронизируется обратно с Exchange Online.

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

-HiddenGroupMembershipEnabled

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

Этот параметр можно использовать для соблюдения правил, требующих скрытия членства в группе от посторонних (например, группы Microsoft 365, представляющей учащихся, зарегистрированных в классе).

Примечание. Этот параметр нельзя изменить после создания группы. Если вы создаете группу со скрытым членством, вы не сможете изменить ее позже, чтобы отобразить членство в ней, или наоборот. Кроме того, любые Группы Microsoft 365 с этим параметром не будут поддерживаться в политиках маркировки конфиденциальности.

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

-IsMemberAllowedToEditContent

{{ Fill IsMemberAllowedToEditContent Description }}

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

-Language

Параметр Language задает предпочитаемый язык для группы Microsoft 365.

Допустимые входные данные для этого параметра — это поддерживаемое значение кода языка и региональных параметров из класса Microsoft платформа .NET Framework CultureInfo. Например, da-DK для датского языка или ja-JP для японского. Дополнительные сведения см. в разделе Класс CultureInfo.

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

-MailboxRegion

Параметр MailboxRegion указывает предпочтительное расположение данных (PDL) для группы Microsoft 365 в средах с несколькими регионами.

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

-ManagedBy

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-Members

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

• Имя
• Псевдоним
• различающееся имя (DN);
• различающееся имя (DN);
• Каноническое краткое имя
• GUID

Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

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

-Name

Этот параметр устарел и больше не используется.

Ранее, если вы указывали значение для этого параметра, добавлялось случайное значение GUID и использовалось в качестве значения свойства Name для группы Microsoft 365 (Name_<RandomGUID>). Теперь значение свойства Name заполняется значением параметра Alias и значением свойства ExternalDirectoryObjectId (<Alias>_<ExternalDirectoryObjectId>).

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

-Notes

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

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

-Owner

Параметр Owner указывает для группы Microsoft 365. Владелец — это член группы, имеющий определенные привилегии, например возможность изменять свойства группы.

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

• Имя
• Псевдоним
• различающееся имя (DN);
• различающееся имя (DN);
• Каноническое краткое имя
• GUID

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

-PrimarySmtpAddress

Параметр PrimarySmtpAddress указывает основной обратный электронный адрес, используемый для получателя. Нельзя использовать параметры EmailAddresses и PrimarySmtpAddress в одной команде.

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

-RequireSenderAuthenticationEnabled

Параметр RequireSenderAuthenticationEnabled указывает, следует ли принимать сообщения только от прошедших проверку подлинности (внутренних) отправителей. Допустимые значения:

• $true: сообщения принимаются только от аутентифицированных (внутренних) отправителей. Сообщения от неуверенных (внешних) отправителей отклоняются.
• $true. Сообщения принимаются только от отправителей, прошедших проверку подлинности (внутренних отправителей). Сообщения от отправителей, не прошедших проверку подлинности (внешних отправителей), будут отклоняться.

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

-SensitivityLabelId

Параметр SensitivityLabelId задает значение GUID метки конфиденциальности, назначенной группе Microsoft 365.

Примечание. В выходных данных командлета Get-UnifiedGroup это свойство называется SensitivityLabel, а не SensitivityLabelId.

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

-SubscriptionEnabled

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

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

-SuppressWarmupMessage

Этот параметр устарел и больше не используется.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 Online, Exchange Online Protection