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

Get-AzureADServicePrincipal

获取服务主体。

语法

Get-AzureADServicePrincipal
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADServicePrincipal
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADServicePrincipal
   -ObjectId <String>
   [-All <Boolean>]
   [<CommonParameters>]

说明

Get-AzureADServicePrincipal cmdlet 获取 Azure Active Directory (AD) 中的服务主体。

示例

示例 1:从目录中检索所有服务主体

PS C:\> Get-AzureADServicePrincipal

ObjectId                             AppId                                DisplayName
--------                             -----                                -----------
00221b6f-4387-4f3f-aa85-34316ad7f956 e5e29b8a-85d9-41ea-b8d1-2162bd004528 Tenant Schema Extension App
012f6450-15be-4e45-b8b4-e630f0fb70fe 00000005-0000-0ff1-ce00-000000000000 Microsoft.YammerEnterprise
06ab01eb-3e77-4d14-ae31-322c7730a65b 09abbdfd-ed23-44ee-a2d9-a627aa1c90f3 ProjectWorkManagement
092aaf41-23e8-46eb-8c3d-fc0ee91cc62f 507bc9da-c4e2-40cb-96a7-ac90df92685c Office365Reports
0ac66e69-5502-4406-a294-6dedeadc8cab 2cf9eb86-36b5-49dc-86ae-9a63135dfa8c AzureTrafficManagerandDNS
0c0a6d9d-48c0-4aa7-b484-4e46f77d8ed9 0f698dd4-f011-4d23-a33e-b36416dcb1e6 Microsoft.OfficeClientService
0cbef08e-a4b5-4dd9-865e-8f521c1c5fb4 0469d4cd-df37-4d93-8a61-f8c75b809164 Microsoft Policy Administration Service
0ea80ff0-a9ea-43b6-b876-d5989efd8228 00000009-0000-0000-c000-000000000000 Microsoft Power BI Reporting and Analytics</dev:code>

此命令从目录中检索所有服务主体。

示例 2:按 ID 检索服务主体

PS C:\> $ServicePrincipalId = (Get-AzureADServicePrincipal -Top 1).ObjectId
PS C:\> Get-AzureADServicePrincipal -ObjectId $ServicePrincipalId

ObjectId                             AppId                                DisplayName
--------                             -----                                -----------
00221b6f-4387-4f3f-aa85-34316ad7f956 e5e29b8a-85d9-41ea-b8d1-2162bd004528 Tenant Schema Extension App

第一个命令使用 Get-AzureADServicePrincipal (./Get-AzureADServicePrincipal.md) cmdlet 获取服务主体的 ID。 命令将 ID 存储在 $ServicePrincipalId 变量中。

第二个命令获取由 $ServicePrincipalId 标识的服务主体。

参数

-All

如果为 true,则返回所有 serviceprincipal 对象。 如果为 false,则返回 Top 参数指定的对象数

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Filter

指定 oData v3.0 筛选器语句。 此参数控制返回的对象。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ObjectId

指定 Azure AD 中服务主体的 ID。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-SearchString

指定搜索字符串。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Top

指定要返回的最大记录数。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

备注

请参阅 Get-AzureADServicePrincipal 到 Microsoft Graph PowerShell 的迁移指南。