Freigeben über

New-AzureADApplicationKeyCredential

Modul:
AzureAD Module

Erstellt Schlüsselanmeldeinformationen für eine Anwendung.

Syntax

Default (Standardwert) 

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

Beschreibung

Mit dem Cmdlet New-AzureADApplicationKeyCredential werden Schlüsselanmeldeinformationen für eine Anwendung erstellt.

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               : aaaaaaaa-0b0b-1c1c-2d2d-333333333333
StartDate           : 11/7/2016 12:00:00 AM
Type                : Symmetric
Usage               : Sign
Value               : {49, 50, 51}

Mit dem ersten Befehl wird die ID einer Anwendung mithilfe des Cmdlets Get-AzureADApplication (./Get-AzureADApplication.md) abgerufen. Der Befehl speichert sie in der Variablen $AppId.

Mit dem zweiten Befehl werden die Anmeldeinformationen für den Anwendungsschlüssel für die Anwendung erstellt, die von $AppId identifiziert wird.

Beispiel 2: Verwenden eines Zertifikats zum Hinzufügen von Anmeldeinformationen für einen 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:\> New-AzureADApplicationKeyCredential -ObjectId $AppID -CustomKeyIdentifier $base64Thumbprint -Type AsymmetricX509Cert -Usage Verify -Value $base64Value -StartDate $cer.GetEffectiveDateString() -EndDate $cer.GetExpirationDateString()

Mit den ersten sieben Befehlen werden Werte für die Anmeldeinformationen des Anwendungsschlüssels erstellt und in Variablen gespeichert.

Mit dem letzten Befehl werden der Anwendung die Schlüsselanmeldeinformationen hinzugefügt.

Parameter

-CustomKeyIdentifier

Gibt eine benutzerdefinierte Schlüssel-ID an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-EndDate

Gibt den Zeitpunkt an, zu dem der Schlüssel als DateTime-Objekt ungültig wird.

Parametereigenschaften

Typ:DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Die zulässigen Werte für diesen Parameter sind:

  • Fortfahren
  • Ignorieren
  • Inquire
  • SilentlyContinue (leise fortfahren)
  • Stopp!
  • Anhalten

Parametereigenschaften

Typ:ActionPreference
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:infa

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InformationVariable

Gibt eine Informationsvariable an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Iv

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ObjectId

Gibt eine eindeutige ID einer Anwendung in Azure Active Directory an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-StartDate

Gibt den Zeitpunkt an, zu dem der Schlüssel als DateTime-Objekt gültig wird.

Parametereigenschaften

Typ:DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Type

Gibt den Typ des Schlüssels an.

Parametereigenschaften

Typ:KeyType
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Usage

Gibt die Schlüsselverwendung an.

Parametereigenschaften

Typ:KeyUsage
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Value

Gibt den Wert für den Schlüssel an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.