Delen via

New-AzureADApplicationKeyCredential

  • Referentie
Module:
AzureAD

Hiermee maakt u een sleutelreferentie voor een toepassing.

Syntaxis

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

Description

De cmdlet New-AzureADApplicationKeyCredential maakt een sleutelreferentie voor een toepassing.

Voorbeelden

Voorbeeld 1: Een nieuwe toepassingssleutelreferentie maken

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}

Met de eerste opdracht wordt de id van een toepassing opgehaald met behulp van de cmdlet Get-AzureADApplication (./Get-AzureADApplication.md). Met de opdracht wordt deze opgeslagen in de variabele $AppId.

Met de tweede opdracht maakt u de toepassingssleutelreferentie voor de toepassing die wordt geïdentificeerd door $AppId.

Voorbeeld 2: een certificaat gebruiken om een toepassingssleutelreferentie toe te voegen

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

Met de eerste zeven opdrachten worden waarden voor de toepassingssleutelreferentie gemaakt en opgeslagen in variabelen.

Met de laatste opdracht voegt u de sleutelreferentie toe aan de toepassing.

Parameters

-CustomKeyIdentifier

Hiermee geeft u een aangepaste sleutel-id.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-EndDate

Hiermee geeft u het tijdstip op waarop de sleutel ongeldig wordt als een DateTime-object.

Type:DateTime
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

  • Doorgaan
  • Negeren
  • Informeren
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliassen:infa
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:String
Aliassen:iv
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ObjectId

Hiermee geeft u een unieke id van een toepassing in Azure Active Directory.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-StartDate

Hiermee geeft u het tijdstip op waarop de sleutel geldig wordt als een DateTime-object.

Type:DateTime
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Type

Hiermee geeft u het type van de sleutel.

Type:KeyType
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Usage

Hiermee geeft u het sleutelgebruik op.

Type:KeyUsage
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Value

Hiermee geeft u de waarde voor de sleutel.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False