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

Get-AzADServicePrincipal

Модуль:
Az.Resources Module

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

Синтаксис

EmptyParameterSet (по умолчанию) 

Get-AzADServicePrincipal
    [-Select <String[]>]
    [-Count]
    [-Filter <String>]
    [-Orderby <String[]>]
    [-Search <String>]
    [-ConsistencyLevel <String>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [-CountVariable <String>]
    [<CommonParameters>]

ObjectIdParameterSet 

Get-AzADServicePrincipal
    -ObjectId <String>
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

SearchStringParameterSet 

Get-AzADServicePrincipal
    -DisplayNameBeginsWith <String>
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

DisplayNameParameterSet 

Get-AzADServicePrincipal
    -DisplayName <String>
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ApplicationIdParameterSet 

Get-AzADServicePrincipal
    -ApplicationId <Guid>
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ApplicationObjectParameterSet 

Get-AzADServicePrincipal
    -ApplicationObject <IMicrosoftGraphApplication>
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

SPNParameterSet 

Get-AzADServicePrincipal
    -ServicePrincipalName <String>
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Описание

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

Примеры

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

Get-AzADServicePrincipal -DisplayName $name

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

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

Get-AzADServicePrincipal -DisplayNameStartsWith $prefix

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

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

Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected

Перечислите первые 10 субъектов-служб и добавьте свойство "Теги" после свойств по умолчанию: DisplayName, "Id", "DeletedDateTime", "ServicePrincipalNames", "AppId"

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

Get-AzADServicePrincipal -ApplicationId $appId

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

Пример 5. Получение субъекта-службы по входным данным конвейера

Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal

Получение субъекта-службы по входным данным конвейера

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

Get-AzADServicePrincipal -Filter "startsWith(DisplayName,'some-name')"

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

Пример 7. Назначение OdataCount переменной

Get-AzADServicePrincipal -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

Назначение OdataCount переменной

Параметры

-AppendSelected

Добавление свойств, выбранных с помощью свойств по умолчанию при включении этого переключателя, работает только с параметром -Select.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ApplicationId

идентификатор приложения serviceprincipal

Свойства параметра

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AppId

Наборы параметров

ApplicationIdParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ApplicationObject

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

Свойства параметра

Тип:IMicrosoftGraphApplication
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ApplicationObjectParameterSet
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ConsistencyLevel

Указывает запрошенный уровень согласованности. URL-адрес документации: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EmptyParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Count

Включение количества элементов

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EmptyParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CountVariable

Указывает количество общих элементов в коллекции. По умолчанию эта переменная будет задана в глобальной области.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EmptyParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

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

Свойства параметра

Тип:PSObject
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisplayName

отображаемое имя serviceprincipal

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

DisplayNameParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisplayNameBeginsWith

Отображаемое имя serviceprincipal начинается с

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:DisplayNameStartsWith, SearchString

Наборы параметров

SearchStringParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Filter

Дополнительные сведения о запросе фильтра см. в разделе "Фильтрация элементов по значениям свойств" https://learn.microsoft.com/en-us/graph/filter-query-parameter

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EmptyParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-First

Возвращает только первые объекты n.

Свойства параметра

Тип:UInt64
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ObjectId

key: id of servicePrincipal

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ИдентификаторОсновногоСервиса (ServicePrincipalId), Идентификатор

Наборы параметров

ObjectIdParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Orderby

Упорядочивание элементов по значениям свойств

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EmptyParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Search

Поиск элементов по фразам поиска

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EmptyParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Select

Выбор свойств для возврата

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ServicePrincipalName

имя serviceprincipal

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:имя участника-службы

Наборы параметров

SPNParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Skip

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

Свойства параметра

Тип:UInt64
Default value: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.

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

IMicrosoftGraphApplication

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

IMicrosoftGraphServicePrincipal