Поделиться через

Get-MsolServicePrincipal

  • Ссылка
Модуль:
MSOnline

Возвращает субъекты-службы из Azure Active Directory.

Синтаксис

Get-MsolServicePrincipal
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Описание

Командлет Get-MsolServicePrincipal получает субъект-службу или список субъектов-служб из Azure Active Directory.

Примеры

Пример 1. Отображение всех субъектов-служб

PS C:\> Get-MsolServicePrincipal

Эта команда отображает все существующие субъекты-службы в клиенте организации.

Пример 2. Получение субъектов-служб с помощью имени

PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"

Эта команда получает все существующие субъекты-службы с именем субъекта-службы, начинающимся с MyApp. Это точное соответствие части appClass имени субъекта-службы до косой черты.

Пример 3. Получение субъекта-службы

PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b

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

Параметры

-All

Указывает, что этот командлет возвращает все результаты. Не указывайте вместе с параметром MaxResults .

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AppPrincipalId

Указывает уникальный идентификатор приложения субъекта-службы, который требуется получить.

Тип:Guid
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-MaxResults

Указывает максимальное количество результатов, возвращаемых этим командлетом. Значение по умолчанию — 500.

Тип:Int32
Position:Named
Default value:500
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ObjectId

Указывает уникальный идентификатор объекта субъекта-службы, который требуется получить.

Тип:Guid
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SearchString

Указывает строку, соответствующую именам субъектов-служб.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ServicePrincipalName

Указывает имя субъекта-службы или субъектов-служб, которые требуется получить. Имя субъекта-службы должно использовать один из следующих форматов:

  • appName
  • appName/hostname
  • допустимый URL-адрес

AppName представляет имя приложения, а имя узла — центр URI для приложения.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TenantId

Указывает уникальный идентификатор клиента, с которым выполняется операция. Значением по умолчанию является клиент текущего пользователя. Этот параметр применяется только к пользователям-партнерам.

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

Выходные данные

Microsoft.Online.Administration.ServicePrincipal[]

Этот командлет возвращает субъект-службу или список субъектов-служб из Azure Active Directory. Каждый участник службы содержит следующие сведения.

  • Objectid. Уникальный идентификатор субъекта-службы.
  • AppPrincipalId. Идентификатор приложения субъекта-службы.
  • DisplayName. Понятное имя субъекта-службы.
  • ServicePrincipalName. Список имен субъектов-служб, связанных с субъектом-службой.
  • AccountEnabled. Значение, указывающее, включена ли учетная запись.