Get-ServicePrincipal

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Online, Security & Compliance, Exchange Online Protection

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

Используйте командлет Get-ServicePrincipal для просмотра сведений о субъектах-службах в облачной организации.

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

Синтаксис

Get-ServicePrincipal
   [[-Identity] <ServicePrincipalIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [<CommonParameters>]

Описание

Субъекты-службы существуют в Azure Active Directory, чтобы определить, какие приложения могут делать, кто может получить доступ к приложениям и к каким ресурсам могут получить доступ приложения. В Exchange Online субъекты-службы — это ссылки на субъекты-службы в Azure AD. Чтобы назначить Exchange Online роли управления доступом на основе ролей (RBAC) субъектам-службам в Azure AD, используйте ссылки на субъекты-службы в Exchange Online. Командлеты *-ServicePrincipal в Exchange Online PowerShell позволяют просматривать, создавать и удалять ссылки на эти субъекты-службы.

Дополнительные сведения см. в статье Объекты приложения и субъекта-службы в Azure Active Directory.

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

Примеры

Пример 1

Get-ServicePrincipal

В этом примере возвращается сводный список всех субъектов-служб.

Пример 2

Get-ServicePrincipal -Identity ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 | Format-List

В этом примере возвращаются подробные сведения о субъекте-службе со значением ServiceId ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1.

Параметры

-Identity

Параметр Identity указывает субъект-службу, который требуется просмотреть. Можно использовать любое значение, однозначно определяющее субъект-службу. Например:

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

Type:	ServicePrincipalIdParameter
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protectionn

-Organization

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

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