New-RoleGroup

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

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

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

Параметр CustomConfigWriteScope указывает существующую область управления на основе конфигурации, которая будет связана с назначениями ролей управления, созданными в этой группе ролей. Если имя области управления содержит пробелы, его необходимо заключить в кавычки ("). Используйте командлет Get-ManagementScope для получения списка существующих областей управления.

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

Используйте командлет Get-ManagementScope для получения списка существующих областей управления.

При использовании параметра CustomRecipientWriteScope невозможно использовать параметр RecipientOrganizationalUnitScope.

Параметр Description указывает описание, которое отображается при просмотре группы ролей с помощью командлета Get-RoleGroup. Заключите это описание в двойные кавычки (").

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

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

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

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

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

Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.

Этот параметр доступен только в PowerShell для соответствия требованиям безопасности & .

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

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

Параметр LinkedCredential указывает имя пользователя и пароль, используемые для доступа к контроллеру домена, указанному параметром LinkedDomainController.

Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential). Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential), а затем используйте имя переменной ($cred) для этого параметра. Для получения дополнительной информации см. Get-Credential.

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

Параметр LinkedDomainController указывает полное доменное имя (FQDN) или IP-адрес контроллера домена в лесу, где находится иностранное usG. Указанный контроллер домена используется для получения сведений о безопасности для внешнего usG, указанного параметром LinkedForeignGroup.

Если вы используете параметр LinkedDomainController, необходимо указать внешний usG с параметром LinkedForeignGroup, и вы не можете использовать параметр Members.

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

Параметр LinkedForeignGroup указывает имя иностранного usG, с которым нужно связать эту группу ролей. Если внешнее имя USG содержит пробелы, заключите имя в кавычки (").

Если используется параметр LinkedForeignGroup, необходимо указать контроллер домена в параметре LinkedDomainController, а параметр Members использовать нельзя.

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

Можно использовать имя, различающееся имя (DN) или основной SMTP-адрес пользователя или usg, которые вы хотите добавить. Если имя пользователя или usg содержит пробелы, заключите имя в кавычки (").

Если вы хотите добавить несколько пользователей или usg, разделите их с помощью запятых.

Параметр Members указывает почтовые ящики или группы USG с поддержкой почты, добавляемые в качестве члена группы ролей. Вы можете определить пользователя или группу по имени, DN или основному значению SMTP-адреса. Можно указать несколько элементов, разделенных запятыми (Value1,Value2,...ValueN). Если значение содержит пробелы, заключите значение в кавычки ("Value 1","Value 2",..."Value N").

При использовании параметра Members нельзя использовать параметры LinkedForeignGroup, LinkedDomainController или LinkedCredential.

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

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

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

Параметр RecipientOrganizationalUnitScope указывает область подразделения, добавленную к назначениям ролей, созданным при создании группы ролей. При использовании параметра RecipientOrganizationalUnitScope невозможно использовать параметр CustomRecipientWriteScope. Чтобы указать подразделение, используйте следующую синтаксическую конструкцию: домен/подразделение. Если имя подразделения содержит пробелы, домен и подразделение необходимо заключить в кавычки (").

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

Список встроенных ролей управления, которые можно назначить группе ролей, см. в разделе Встроенные роли управления.

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

Параметр SamAccountName (также известный как имя группы или учетная запись пользователя в версиях, предшествующих Windows 2000) определяет идентификатор объекта, совместимый с более ранними версиями клиента Microsoft Windows и серверных операционных систем. Значение может содержать буквы, цифры, пробелы, точки (.) и следующие символы: !, #, $, %, ^, &, -, _, {, }и ~. В качестве последнего символа невозможно использовать точку. Символы Юникода разрешены, однако из-за диакритических знаков могут возникать конфликты (например, соответствие o и ö). Максимальная длина составляет 20 символов.

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

{{ Fill WellKnownObject Description }}

Параметр WhatIf не работает в PowerShell для соответствия требованиям безопасности & .

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