你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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 个服务主体，并在默认属性后追加属性“Tags”：“DisplayName”、“Id”、“DeletedDateTime”、“ServicePrincipalNames”、“AppId”

示例 4：按应用程序 ID 获取服务主体

Get-AzADServicePrincipal -ApplicationId $appId

按应用程序 ID 获取服务主体

示例 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
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ApplicationId

serviceprincipal 的应用程序 ID

参数属性

类型:	Guid
默认值:	None
支持通配符:	False
不显示:	False
别名:	AppId

参数集

ApplicationIdParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ApplicationObject

服务主体对象可用作管道输入。

参数属性

类型:	IMicrosoftGraphApplication
默认值:	None
支持通配符:	False
不显示:	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
默认值:	None
支持通配符:	False
不显示:	False

参数集

EmptyParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Count

包括项计数

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

EmptyParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-CountVariable

指定集合中项总数的计数。默认情况下，此变量将在全局范围内设置。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

EmptyParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:	PSObject
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DisplayName

serviceprincipal 显示名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

DisplayNameParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DisplayNameBeginsWith

serviceprincipal 显示名称以开头

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	DisplayNameStartsWith, SearchString

参数集

SearchStringParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Filter

按属性值筛选项，有关筛选查询的更多详细信息，请参阅： https://learn.microsoft.com/en-us/graph/filter-query-parameter

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

EmptyParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-First

仅获取第一个“n”对象。

参数属性

类型:	UInt64
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ObjectId

键：servicePrincipal 的 ID

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	ServicePrincipalId, Id

参数集

ObjectIdParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Orderby

按属性值对项进行排序

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

EmptyParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Search

按搜索短语搜索项目

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

EmptyParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Select

选择要返回的属性

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ServicePrincipalName

serviceprincipal 名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	SPN

参数集

SPNParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Skip

忽略第一个“n”对象，然后获取剩余的对象。

参数属性

类型:	UInt64
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

Get-AzADServicePrincipal

语法

EmptyParameterSet （默认值）

ObjectIdParameterSet

SearchStringParameterSet

DisplayNameParameterSet

ApplicationIdParameterSet

ApplicationObjectParameterSet

SPNParameterSet

说明

示例

示例 1：按显示名称获取服务主体

示例 2：搜索服务主体显示名称开头

示例 3：列出服务主体

示例 4：按应用程序 ID 获取服务主体

示例 5：按管道输入获取服务主体

示例 6：使用筛选器获取服务主体

示例 7：将 OdataCount 分配到变量

参数

-AppendSelected

参数属性

参数集

-ApplicationId

参数属性

参数集

-ApplicationObject

参数属性

参数集

-ConsistencyLevel

参数属性

参数集

-Count

参数属性

参数集

-CountVariable

参数属性

参数集

-DefaultProfile

参数属性

参数集

-DisplayName

参数属性

参数集

-DisplayNameBeginsWith

参数属性

参数集

-Filter

参数属性

参数集

-First

参数属性

参数集

-ObjectId

参数属性

参数集

-Orderby

参数属性

参数集

-Search

参数属性

参数集

-Select

参数属性

参数集

-ServicePrincipalName

参数属性

参数集

-Skip

参数属性

参数集

CommonParameters

输入

IMicrosoftGraphApplication

输出

IMicrosoftGraphServicePrincipal

反馈