New-AzureADApplicationKeyCredential
アプリケーションのキー資格情報を作成します。
構文
New-AzureADApplicationKeyCredential
-ObjectId <String>
[-CustomKeyIdentifier <String>]
[-StartDate <DateTime>]
[-EndDate <DateTime>]
[-Type <KeyType>]
[-Usage <KeyUsage>]
[-Value <String>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
説明
New-AzureADApplicationKeyCredential コマンドレットは、アプリケーションのキー資格情報を作成します。
例
例 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 コマンドレットを使用してアプリケーションの ID を取得します。 コマンドは、それを $AppId 変数に格納します。
2 番目のコマンドは、$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()
最初の 7 つのコマンドは、アプリケーション キー資格情報の値を作成し、変数に格納します。
最後のコマンドでは、証明書を使用してアプリケーション キーの資格情報を追加します。
パラメーター
-CustomKeyIdentifier
カスタム キー ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-EndDate
DateTime オブジェクトとしてキーが無効になる時刻を指定します。
型: | DateTime |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-InformationAction
このコマンドレットが情報イベントにどのように応答するかを指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- 照会
- SilentlyContinue
- Stop
- [中断]
型: | ActionPreference |
Aliases: | infa |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InformationVariable
情報変数を指定します。
型: | String |
Aliases: | iv |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ObjectId
Azure Active Directory 内のアプリケーションの一意の ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-StartDate
キーが DateTime オブジェクトとして有効になる時刻を指定します。
型: | DateTime |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Type
キーの種類を指定します。
型: | KeyType |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Usage
キーの使用法を指定します。
型: | KeyUsage |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Value
キーの値を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |