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

Get-AzureRmADServicePrincipal

  • Ссылка
Модуль:
AzureRM.Resources

Фильтрует субъекты-службы Active Directory.

Предупреждение

Модуль AzureRM PowerShell официально объявлен устаревшим с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

Get-AzureRmADServicePrincipal
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayNameBeginsWith <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ObjectId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationObject <PSADApplication>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ServicePrincipalName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]

Описание

Фильтрует субъекты-службы Active Directory.

Примеры

Пример 1. Перечисление субъектов-служб AD

PS C:\> Get-AzureRmADServicePrincipal

Перечисляет все субъекты-службы AD в клиенте.

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

PS C:\> Get-AzureRmADServicePrincipal -First 100

Перечисляет первые 100 субъектов-служб AD в клиенте.

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

PS C:\> Get-AzureRmADServicePrincipal -ServicePrincipalName 36f81fc3-b00f-48cd-8218-3879f51ff39f

Перечисляет субъекты-службы с помощью имени субъекта-службы "36f81fc3-b00f-48cd-8218-3879f51ff39f".

Пример 4. Вывод списка субъектов-служб по строке поиска

PS C:\> Get-AzureRmADServicePrincipal -SearchString "Web"

Выводит список всех субъектов-служб AD, отображаемое имя которого начинается с "Web".

Пример 5. Перечисление субъектов-служб путем подключения

PS C:\> Get-AzureRmADApplication -ObjectId 39e64ec6-569b-4030-8e1c-c3c519a05d69 | Get-AzureRmADServicePrincipal

Возвращает приложение AD с идентификатором объекта "39e64ec6-569b-4030-8e1c-c3c519a05d69" и передает его командлету Get-AzureRmADServicePrincipal, чтобы перечислить все субъекты-службы для этого приложения.

Параметры

-ApplicationId

Идентификатор приложения субъекта-службы.

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

-ApplicationObject

Объект приложения, субъект-служба которого извлекается.

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

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

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

-DisplayName

Отображаемое имя субъекта-службы.

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

-DisplayNameBeginsWith

Строка поиска субъекта-службы.

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

-First

Максимальное количество возвращаемых объектов.

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

-IncludeTotalCount

Сообщает количество объектов в наборе данных. В настоящее время этот параметр ничего не делает.

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

-ObjectId

Идентификатор объекта субъекта-службы.

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

-ServicePrincipalName

Имя участника-службы.

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

-Skip

Игнорирует первые N-объекты, а затем получает оставшиеся объекты.

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

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

String

Guid

PSADApplication

Параметры: ApplicationObject (ByValue)

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

PSADServicePrincipal