Delen via

New-AzureADApplicationKeyCredential

  • Referentie
Module:
AzureADPreview

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

Met de cmdlet New-AzureADApplicationKeyCredential wordt een sleutelreferentie voor een toepassing gemaakt.

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 . Met de opdracht wordt deze opgeslagen in de variabele $AppId.

Met de tweede opdracht maakt u de referentie van de toepassingssleutel voor de toepassing die is 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:\> $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()

Met de eerste zeven opdrachten worden waarden gemaakt voor de referentie van de toepassingssleutel en worden deze opgeslagen in variabelen.

In de laatste opdracht wordt een certificaat gebruikt om een referentie voor de toepassingssleutel toe te voegen.

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.

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 op.

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