New-ServicePrincipal
Этот командлет доступен только в облачной службе.
Используйте командлет New-ServicePrincipal для создания субъектов-служб в облачной организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
New-ServicePrincipal
-AppId <String>
-ObjectId <String>
-ServiceId <String>
[-Confirm]
[-DisplayName <String>]
[-Organization <OrganizationIdParameter>]
[-WhatIf]
[<CommonParameters>]
Описание
В Microsoft Entra ID существуют субъекты служб, которые определяют, что могут делать приложения, кто может получать доступ к приложениям и к каким ресурсам могут получать доступ приложения. В Exchange Online субъекты служб — это ссылки на субъекты служб в Microsoft Entra ID. Чтобы назначить роли управления доступом на основе ролей (RBAC) в Exchange Online субъектам службы в Microsoft Entra ID, следует использовать ссылки на субъекты службы в Exchange Online. Командлеты *-ServicePrincipal в PowerShell в Exchange Online позволяют просматривать, создавать и удалять ссылки на эти субъекты-службы.
Дополнительные сведения см. в разделе Объекты субъектов приложений и служб в Microsoft Entra ID.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
New-ServicePrincipal -AppId 71487acd-ec93-476d-bd0e-6c8b31831053 -ObjectId 6233fba6-0198-4277-892f-9275bf728bcc
В этом примере создается новый субъект-служба в Exchange Online с указанными значениями AppId и ObjectId.
Параметры
-AppId
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр AppId указывает уникальное значение GUID AppId для субъекта-службы. Например, ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1.
Допустимое значение этого параметра доступно в следующих расположениях:
- Свойство AppId в выходных данных командлета Get-MgServicePrincipal в Microsoft Graph PowerShell.
- Свойство ИД приложения из Корпоративных приложений в Центре администрирования Microsoft Entra: https://portal.azure.com/#view/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/~/AppAppsPreview/menuId~/null.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisplayName
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр DisplayName указывает понятное имя субъекта-службы. Если имя содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ObjectId
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр ObjectId указывает уникальное значение GUID ObjectId для субъекта-службы. Например, 7c7599b2-23af-45e3-99ff-0025d148e929.
Допустимое значение этого параметра доступно в следующих расположениях:
- Свойство Id в выходных данных командлета Get-MgServicePrincipal в Microsoft Graph PowerShell.
- Свойство "ИД объекта" из корпоративных приложений в Центре администрирования Microsoft Entra: https://portal.azure.com/#view/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/~/AppAppsPreview/menuId~/null.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Organization
Применимо: безопасность & соответствие требованиям
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | OrganizationIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ServiceId
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр устарел. Вместо него используйте параметр ObjectId.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Параметр WhatIf не поддерживается в PowerShell безопасности и соответствия требованиям.
Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.