Share via

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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AppPrincipalId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxResults

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

Type:Int32
Position:Named
Default value:500
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServicePrincipalName

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

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

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

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

Microsoft.Online.Administration.ServicePrincipal[]

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

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