你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Get-MsolServicePrincipal
从 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 cmdlet 从 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此命令获取具有特定应用程序主体 ID 的服务主体。
参数
-All
指示此 cmdlet 返回所有结果。 不要与 MaxResults 参数一起指定。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-AppPrincipalId
指定要获取的服务主体的唯一应用程序 ID。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-MaxResults
指定此 cmdlet 返回的最大结果数。 默认值为 500。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | 500 |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ObjectId
指定要获取的服务主体的唯一对象 ID。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-SearchString
指定与服务主体名称匹配的字符串。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ServicePrincipalName
指定要获取的服务主体或服务主体的名称。 SPN 必须使用以下格式之一：
appNameappName/hostname- 有效的 URL
AppName 表示应用程序的名称，主机名表示应用程序的 URI 颁发机构。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-TenantId
指定要对其执行操作的租户的唯一 ID。 默认值为当前用户的租户。 此参数仅适用于合作伙伴用户。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
输出
Microsoft.Online.Administration.ServicePrincipal[]
此 cmdlet 从 Azure Active Directory 返回服务主体或服务主体列表。 每个服务主体包含以下信息：
- ObjectId。 服务主体的唯一标识符。
- AppPrincipalId。 服务主体的应用程序标识符。
- DisplayName。 服务主体的友好名称。
- ServicePrincipalName。 与服务主体关联的服务主体名称) (SPN 的列表。
- AccountEnabled。 指示帐户是否已启用的值。