New-EntraApplicationKeyCredential

New-EntraApplicationKeyCredential

    -ApplicationId <String>
    [-CustomKeyIdentifier <String>]
    [-Type <KeyType>]
    [-Usage <KeyUsage>]
    [-Value <String>]
    [-EndDate <DateTime>]
    [-StartDate <DateTime>]
    [<CommonParameters>]

L’applet New-EntraApplicationKeyCredential de commande crée des informations d’identification de clé pour une application.

Une application peut utiliser cette commande avec Remove-EntraApplicationKeyCredential pour automatiser le déploiement de ses clés arrivant à expiration.

Dans le cadre de la validation de la demande, la preuve de possession d’une clé existante est vérifiée avant que l’action puisse être effectuée.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
$params = @{
    ApplicationId = $application.Id
    CustomKeyIdentifier = 'EntraPowerShellKey'
    StartDate = '2024-03-21T14:14:14Z'
    Type = 'Symmetric'
    Usage = 'Sign'
    Value = '<my-value>'
}
New-EntraApplicationKeyCredential @params

CustomKeyIdentifier : {84, 101, 115, 116}
EndDate             : 2024-03-21T14:14:14Z
KeyId               : aaaaaaaa-0b0b-1c1c-2d2d-333333333333
StartDate           : 2025-03-21T14:14:14Z
Type                : Symmetric
Usage               : Sign
Value               : {49, 50, 51}

Cet exemple montre comment créer des informations d’identification de clé d’application.

• -ApplicationId Spécifie un ID unique d’une application
• -CustomKeyIdentifier Spécifie un ID de clé personnalisé.
• -StartDate Spécifie l’heure à laquelle la clé devient valide en tant qu’objet DateTime.
• -Type Spécifie le type de la clé.
• -Usage Spécifie l’utilisation de la clé. pour AsymmetricX509Cert l’utilisation doit être Verifyet pour X509CertAndPassword l’utilisation doit être Sign.
• -Value Spécifie la valeur de la clé.

Vous pouvez utiliser l’applet Get-EntraApplication de commande pour récupérer l’ID d’objet de l’application.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
$cer = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2 #create a new certificate object
$cer.Import('C:\Users\ContosoUser\appcert.cer')
$bin = $cer.GetRawCertData()
$base64Value = [System.Convert]::ToBase64String($bin)
$bin = $cer.GetCertHash()
$base64Thumbprint = [System.Convert]::ToBase64String($bin)
$keyid = [System.Guid]::NewGuid().ToString()

$params = @{
    ApplicationId = $application.Id
    CustomKeyIdentifier = $base64Thumbprint
    Type = 'AsymmetricX509Cert'
    Usage = 'Verify'
    Value = $base64Value
    StartDate = $cer.GetEffectiveDateString()
    EndDate = $cer.GetExpirationDateString()
}
New-EntraApplicationKeyCredential @params

Cet exemple montre comment créer des informations d’identification de clé d’application.

• -ApplicationId Spécifie un ID unique d’une application
• -CustomKeyIdentifier Spécifie un ID de clé personnalisé.
• -StartDate Spécifie l’heure à laquelle la clé devient valide en tant qu’objet DateTime.
• -EndDate Spécifie l’heure à laquelle la clé devient non valide en tant qu’objet DateTime.
• -Type Spécifie le type de la clé.
• -Usage Spécifie l’utilisation de la clé. pour AsymmetricX509Cert l’utilisation doit être Verifyet pour X509CertAndPassword l’utilisation doit être Sign.
• -Value Spécifie la valeur de la clé.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.