Compartir a través de


New-AzureADApplicationKeyCredential

Crea una credencial de clave para una aplicación.

Sintaxis

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

Description

El cmdlet New-AzureADApplicationKeyCredential crea una credencial de clave para una aplicación.

Ejemplos

Ejemplo 1: Creación de una nueva credencial de clave de aplicación

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}

El primer comando obtiene el identificador de una aplicación mediante el cmdlet Get-AzureADApplication (./Get-AzureADApplication.md). El comando lo almacena en la variable $AppId.

El segundo comando crea la credencial de clave de aplicación para la aplicación identificada por $AppId.

Ejemplo 2: Uso de un certificado para agregar una credencial de clave de aplicación

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()

Los siete primeros comandos crean valores para la credencial de clave de aplicación y los almacenan en variables.

El comando final agrega la credencial de clave a la aplicación.

Parámetros

-CustomKeyIdentifier

Especifica un identificador de clave personalizado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EndDate

Especifica la hora en que la clave deja de ser válida como un objeto DateTime.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignorar
  • Consultar
  • SilentlyContinue
  • Stop
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ObjectId

Especifica un identificador único de una aplicación en Azure Active Directory.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StartDate

Especifica la hora en que la clave se vuelve válida como un objeto DateTime.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Type

Especifica el tipo de la clave.

Tipo:KeyType
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Usage

Especifica el uso de la clave.

Tipo:KeyUsage
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Value

Especifica el valor de la clave.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False