New-AzureADApplicationKeyCredential
Erstellt Schlüsselanmeldeinformationen für eine Anwendung.
Syntax
New-AzureADApplicationKeyCredential
-ObjectId <String>
[-CustomKeyIdentifier <String>]
[-StartDate <DateTime>]
[-EndDate <DateTime>]
[-Type <KeyType>]
[-Usage <KeyUsage>]
[-Value <String>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Beschreibung
Das Cmdlet New-AzureADApplicationKeyCredential erstellt Schlüsselanmeldeinformationen für eine Anwendung.
Beispiele
Beispiel 1: Erstellen neuer Anmeldeinformationen für den Anwendungsschlüssel
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}
Der erste Befehl ruft die ID einer Anwendung mithilfe des Cmdlets Get-AzureADApplication ab. Der Befehl speichert sie in der variablen $AppId.
Mit dem zweiten Befehl werden die Anmeldeinformationen des Anwendungsschlüssels für die anwendung erstellt, die durch $AppId identifiziert wird.
Beispiel 2: Verwenden eines Zertifikats zum Hinzufügen von Anmeldeinformationen für den Anwendungsschlüssel
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()
Die ersten sieben Befehle erstellen Werte für die Anmeldeinformationen des Anwendungsschlüssels und speichern sie in Variablen.
Der letzte Befehl verwendet ein Zertifikat, um Anmeldeinformationen für den Anwendungsschlüssel hinzuzufügen.
Parameter
-CustomKeyIdentifier
Gibt eine benutzerdefinierte Schlüssel-ID an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-EndDate
Gibt den Zeitpunkt an, zu dem der Schlüssel als DateTime-Objekt ungültig wird.
Typ: | DateTime |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-InformationAction
Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.
Zulässige Werte für diesen Parameter:
- Weiter
- Ignorieren
- Diagnosetool
- SilentlyContinue
- Beenden
- Angehalten
Typ: | ActionPreference |
Aliase: | infa |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-InformationVariable
Gibt eine Informationsvariable an.
Typ: | String |
Aliase: | iv |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ObjectId
Gibt eine eindeutige ID einer Anwendung in Azure Active Directory an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-StartDate
Gibt den Zeitpunkt an, zu dem der Schlüssel als DateTime-Objekt gültig wird.
Typ: | DateTime |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Type
Gibt den Typ des Schlüssels an.
Typ: | KeyType |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Usage
Gibt die Schlüsselverwendung an.
Typ: | KeyUsage |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Value
Gibt den Wert für den Schlüssel an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |