New-AzureADApplicationKeyCredential
Crée des informations d’identification de clé pour une application.
Syntaxe
New-AzureADApplicationKeyCredential
-ObjectId <String>
[-CustomKeyIdentifier <String>]
[-StartDate <DateTime>]
[-EndDate <DateTime>]
[-Type <KeyType>]
[-Usage <KeyUsage>]
[-Value <String>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Description
L’applet de commande New-AzureADApplicationKeyCredential crée des informations d’identification de clé pour une application.
Exemples
Exemple 1 : Créer des informations d’identification de clé d’application
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}La première commande obtient l’ID d’une application à l’aide de l’applet de commande Get-AzureADApplication (./Get-AzureADApplication.md). La commande le stocke dans la variable $AppId.
La deuxième commande crée les informations d’identification de clé d’application pour l’application identifiée par $AppId.
Exemple 2 : Utiliser un certificat pour ajouter des informations d’identification de clé d’application
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:\> New-AzureADApplicationKeyCredential -ObjectId $AppID -CustomKeyIdentifier $base64Thumbprint -Type AsymmetricX509Cert -Usage Verify -Value $base64Value -StartDate $cer.GetEffectiveDateString() -EndDate $cer.GetExpirationDateString()Les sept premières commandes créent des valeurs pour les informations d’identification de clé d’application et les stockent dans des variables.
La commande finale ajoute les informations d’identification de clé à l’application.
Paramètres
-CustomKeyIdentifier
Spécifie un ID de clé personnalisé.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-EndDate
Spécifie l’heure à laquelle la clé devient non valide en tant qu’objet DateTime.
| Type: | DateTime |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-InformationAction
Spécifie la façon dont cette applet de commande répond à un événement d’informations.
Les valeurs valides pour ce paramètre sont :
- Continuer
- Ignorer
- Inquire
- SilentlyContinue
- Arrêter
- Interrompre
| Type: | ActionPreference |
| Alias: | infa |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InformationVariable
Spécifie une variable d’information.
| Type: | String |
| Alias: | iv |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ObjectId
Spécifie un ID unique d’une application dans Azure Active Directory.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-StartDate
Spécifie l’heure à laquelle la clé devient valide en tant qu’objet DateTime.
| Type: | DateTime |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Type
Spécifie le type de la clé.
| Type: | KeyType |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Usage
Spécifie l’utilisation de la clé.
| Type: | KeyUsage |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Value
Spécifie la valeur de la clé.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |