Get-ServicePrincipal
Этот командлет доступен только в облачной службе.
Используйте командлет Get-ServicePrincipal для просмотра сведений о субъектах-службах в облачной организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Get-ServicePrincipal
[[-Identity] <ServicePrincipalIdParameter>]
[-Organization <OrganizationIdParameter>]
[<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
Get-ServicePrincipal
В этом примере возвращается сводный список всех субъектов-служб в организации.
Пример 2
Get-ServicePrincipal -Identity ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 | Format-List
В этом примере возвращаются подробные сведения о субъекте-службе со значением ObjectId ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1.
Параметры
-Identity
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Identity указывает субъект-службу, который вы хотите просмотреть. Можно использовать любое значение, которое однозначно идентифицирует субъект-службу. Например:
- имя;
- различающееся имя (DN);
- GUID
- AppId
- ObjectId
Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.
Свойства параметров
| Тип: | ServicePrincipalIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Organization
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | OrganizationIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.