共用方式為


Get-MsolServicePrincipalCredential

取得與服務主體相關聯的認證。

Syntax

Get-MsolServicePrincipalCredential
   -ObjectId <Guid>
   -ReturnKeyValues <Boolean>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipalCredential
   -ReturnKeyValues <Boolean>
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipalCredential
   -ReturnKeyValues <Boolean>
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

Get-MsolServicePrincipalCredential Cmdlet 會取得與服務主體相關聯的認證。

範例

範例 1:取得認證屬性

PS C:\> Get-MsolServicePrincipalCredential -ServicePrincipalName "MyApp/myApp.com"

此命令會取得所有認證屬性,但認證值除外,與服務主體名稱相關聯的認證屬性, (SPN) MyApp/myApp.com。 SPN 必須遵循 appClass/hostname 格式,其中 appClass 代表應用程式類別 (「MyApp」) ,而主機名稱代表應用程式 (myApp.com) 的主機名稱。

參數

-AppPrincipalId

指定要取得認證的服務主體應用程式識別碼。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

指定要取得認證的服務主體的唯一物件識別碼。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReturnKeyValues

指出此 Cmdlet 是否傳回索引鍵值。

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServicePrincipalName

指定要從中取得認證的服務主體名稱。 SPN 必須使用下列其中一種格式:

  • appName
  • appName/hostname
  • 有效的 URL

AppName 代表應用程式的名稱。 主機名稱代表應用程式的 URI 授權單位。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

指定要在其中執行作業之租使用者的唯一識別碼。 預設值為目前使用者的租使用者。 此參數僅適用于合作夥伴使用者。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

輸出

Microsoft.Online.Administration.ServicePrincipalCredential[]

此 Cmdlet 會傳回與服務主體相關聯的認證。 每個傳回的物件都包含下列資訊:

  • 類型。 服務主體認證的類型 (非對稱/對稱/密碼) 。
  • 值。 認證的值。
    • 如果認證類型為憑證,則此值代表 base 64 編碼憑證。
    • 如果認證類型是對稱的,則表示 AES 金鑰。
  • KeyGroupId。 保留供內部使用的識別碼。
  • KeyId。 索引鍵的唯一識別碼。
  • StartDate。 認證使用方式的有效開始日期。
  • EndDate。 認證使用方式的有效結束日期。
  • 使用。 指定認證是否用來「簽署」或「驗證」權杖。