你当前正在访问 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 必须使用以下格式之一:

  • appName
  • appName/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。 指示帐户是否已启用的值。