共用方式為

New-AzureADApplicationKeyCredential

  • 參考
模組:
AzureADPreview

建立應用程式的金鑰認證。

語法

New-AzureADApplicationKeyCredential
   -ObjectId <String>
   [-CustomKeyIdentifier <String>]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-Type <KeyType>]
   [-Usage <KeyUsage>]
   [-Value <String>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

New-AzureADApplicationKeyCredential Cmdlet 會建立應用程式的密鑰認證。

範例

範例 1：建立新的應用程式密鑰認證

PS C:\> $AppID = (Get-AzureADApplication -Top 1).Objectid
PS C:\> New-AzureADApplicationKeyCredential -ObjectId $AppId -CustomKeyIdentifier "Test" -StartDate "11/7/2016" -Type "Symmetric" -Usage "Sign" -Value "123"

CustomKeyIdentifier : {84, 101, 115, 116}
EndDate             : 11/7/2017 12:00:00 AM
KeyId               : a5845538-3f67-402d-a03e-36d768f1441e
StartDate           : 11/7/2016 12:00:00 AM
Type                : Symmetric
Usage               : Sign
Value               : {49, 50, 51}

第一個命令會使用 Get-AzureADApplication Cmdlet 取得應用程式的標識碼。 命令會將它儲存在 $AppId 變數中。

第二個命令會為$AppId所識別的應用程式建立應用程式密鑰認證。

範例 2：使用憑證來新增應用程式密鑰認證

PS C:\> $cer = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2 #create a new certificate object
PS C:\> $cer.Import("C:\Users\PFuller\Desktop\abc.cer") 
PS C:\> $bin = $cer.GetRawCertData()
PS C:\> $base64Value = [System.Convert]::ToBase64String($bin)
PS C:\> $bin = $cer.GetCertHash()
PS C:\> $base64Thumbprint = [System.Convert]::ToBase64String($bin)
PS C:\> $keyid = [System.Guid]::NewGuid().ToString() 
PS C:\> New-AzureADApplicationKeyCredential -ObjectId 009d786a-3503-4217-b8ab-db03d71c179a -CustomKeyIdentifier $base64Thumbprint -Type AsymmetricX509Cert -Usage Verify -Value $base64Value -StartDate $cer.GetEffectiveDateString() -EndDate $cer.GetExpirationDateString()

前七個命令會建立應用程式密鑰認證的值，並將其儲存在變數中。

最後一個命令會使用憑證來新增應用程式密鑰認證。

參數

-CustomKeyIdentifier

指定自訂金鑰識別碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-EndDate

指定當機碼當做 DateTime 物件無效的時間。

類型:DateTime
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-InformationAction

指定此 Cmdlet 如何回應資訊事件。

此參數可接受的值為：

  • 繼續
  • 忽略
  • 詢問
  • SilentlyContinue
  • Stop
  • 暫止
類型:ActionPreference
別名:infa
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InformationVariable

指定資訊變數。

類型:String
別名:iv
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ObjectId

指定 Azure Active Directory 中應用程式的唯一標識碼。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-StartDate

指定當機碼成為 DateTime 物件的有效時間。

類型:DateTime
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Type

指定索引鍵的類型。

類型:KeyType
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Usage

指定金鑰使用方式。

類型:KeyUsage
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Value

指定索引鍵的值。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False