New-RoleAssignmentPolicy
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Используйте командлет New-RoleAssignmentPolicy для создания политик назначения ролей управления в организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
New-RoleAssignmentPolicy
[-Name] <String>
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-IsDefault]
[-Roles <RoleIdParameter[]>]
[-WhatIf]
[<CommonParameters>] Описание
После создания политики назначения ее можно назначать пользователям с помощью командлетов New-Mailbox, Set-Mailbox или Enable-Mailbox. Если новая политика назначения устанавливается как политика по умолчанию, она будет назначаться всем новым почтовым ящикам, для которых политика назначения не задана явным образом.
Роли управления можно добавить в политику назначения как при ее создании, так и позднее. После создания политики назначения необходимо назначить ей по крайней мере одну роль управления, чтобы применить разрешения к почтовым ящикам. Если никакие роли для новой политики назначения не заданы, назначенные этой политике пользователи не смогут управлять конфигурацией своих почтовых ящиков. Чтобы назначить роль управления после создания политики назначения, используйте командлет New-ManagementRoleAssignment. Дополнительные сведения см. в статье Управление политиками назначения ролей.
Дополнительные сведения о политиках назначения см. в разделе О политиках назначения ролей управления.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
New-RoleAssignmentPolicy -Name "End User Policy"
Set-Mailbox -Identity Joe -RoleAssignmentPolicy "End User Policy"В этом примере создается политика назначения. После создания политики назначения ее можно назначить почтовому ящику с помощью командлета Set-Mailbox.
Пример 2
New-RoleAssignmentPolicy -Name "Default End User Policy" -IsDefaultВ этом примере создается политика назначения с помощью переключателя IsDefault.
Пример 3
New-RoleAssignmentPolicy -Name "Limited End User Policy" -Roles "MyPersonalInformation", "MyDistributionGroupMembership", "MyVoiceMail" -IsDefault
Get-Mailbox -ResultSize Unlimited | Set-Mailbox -RoleAssignmentPolicy "Limited End User Policy"В этом примере создается политика назначения, позволяющая пользователям менять персональные данные, а также управлять своим членством в группах рассылки и голосовой почтой. Новая политика назначения создается как новая политика назначения по умолчанию. Затем использование новой политики назначения настраивается для всех существующих почтовых ящиков.
Сначала новая политика назначения создается и задается как новая политика назначения по умолчанию.
Так как установка нового назначения ролей по умолчанию применяется только к новым почтовым ящикам или почтовым ящикам, перемещенным из предыдущих версий Exchange, командлет Set-Mailbox используется для настройки новой политики назначения во всех существующих почтовых ящиках.
Параметры
-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
Параметр Description указывает описание, отображаемое при просмотре политики назначения роли с помощью командлета Get-RoleAssignmentPolicy. Заключите это описание в двойные кавычки (").
| 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 |
-IsDefault
Переключатель IsDefault позволяет установить политику назначения в качестве политики по умолчанию. Для этого переключателя не требуется указывать значение.
Новым почтовым ящикам или почтовым ящикам, перемещенным из предыдущих версий Exchange, назначается политика назначения по умолчанию, если не указана явная политика назначения.
Задание политики назначения по умолчанию не меняет назначения ролей в существующих почтовых ящиках. Для изменения политик назначения в существующих почтовых ящиках используйте командлет Set-Mailbox.
| 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 |
-Name
Параметр Name указывает имя новой политики назначения. Если имя политики назначения содержит пробелы, его необходимо заключить в кавычки ("). Длина этого имени не должна превышать 64 символов.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| 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 |
-Roles
Параметр Roles указывает роли управления, назначаемые политике назначения ролей при ее создании. Если имя роли содержит пробелы, его необходимо заключить в кавычки ("). Для назначения нескольких ролей разделите их имена запятыми.
Список встроенных ролей управления, которые можно назначить группе ролей, см. в разделе Встроенные роли управления.
| Type: | RoleIdParameter[] |
| 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 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.