New-AzApplicationGatewaySslCertificate

Modul:
Az.Network Module

Erstellt ein SSL-Zertifikat für ein Azure Anwendungsgateway.

Syntax

Default (Standard) 

New-AzApplicationGatewaySslCertificate
    -Name <String>
    [-CertificateFile <String>]
    [-Password <SecureString>]
    [-KeyVaultSecretId <String>]
    [-HsmKeyId <String>]
    [-HsmPublicCertData <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzApplicationGatewaySslCertificate erstellt ein SSL-Zertifikat für ein Azure Anwendungsgateway.

Beispiele

Beispiel 1: Erstellen eines SSL-Zertifikats für ein Azure Anwendungsgateway.

$password = ConvertTo-SecureString -String "****" -AsPlainText -Force
$cert = New-AzApplicationGatewaySslCertificate -Name "Cert01" -CertificateFile "D:\cert01.pfx" -Password $password

Mit diesem Befehl wird ein SSL-Zertifikat namens Cert01 für das Standardanwendungsgateway erstellt und das Ergebnis in der Variablen namens $Cert gespeichert.

Beispiel 2: Erstellen Eines SSL-Zertifikats mit KeyVault Secret (version-less secretId) und Hinzufügen zu einem Anwendungsgateway.

$secret = Get-AzKeyVaultSecret -VaultName "keyvault01" -Name "sslCert01"
$secretId = $secret.Id.Replace($secret.Version, "") # https://<keyvaultname>.vault.azure.net/secrets/
$cert = New-AzApplicationGatewaySslCertificate -Name "Cert01" -KeyVaultSecretId $secretId

Rufen Sie den geheimen Schlüssel ab, und erstellen Sie ein SSL-Zertifikat mithilfe von New-AzApplicationGatewaySslCertificate. Hinweis: Da hier versionslose secretId bereitgestellt wird, synchronisiert das Anwendungsgateway das Zertifikat in regelmäßigen Abständen mit keyVault.

Beispiel 3: Erstellen Eines SSL-Zertifikats mit KeyVault Secret und Hinzufügen zu einem Anwendungsgateway.

$secret = Get-AzKeyVaultSecret -VaultName "keyvault01" -Name "sslCert01"
$secretId = $secret.Id # https://<keyvaultname>.vault.azure.net/secrets/<hash>
$cert = New-AzApplicationGatewaySslCertificate -Name "Cert01" -KeyVaultSecretId $secretId

Rufen Sie den geheimen Schlüssel ab, und erstellen Sie ein SSL-Zertifikat mithilfe von New-AzApplicationGatewaySslCertificate. Hinweis: Wenn es erforderlich ist, dass das Anwendungsgateway das Zertifikat mit dem KeyVault synchronisiert, geben Sie die versionslose secretId an.

Beispiel 4: Erstellen Eines SSL-Zertifikats mit verwaltetem HSM und Hinzufügen zu einem Anwendungsgateway.

$cert = New-AzApplicationGatewaySslCertificate -Name "Cert01" -HsmKeyId "https://myhsm.managedhsm.azure.net/keys/mykey/abc123"

Erstellen Sie ein SSL-Zertifikat, das auf einen in managed HSM New-AzApplicationGatewaySslCertificategespeicherten Schlüssel verweist.

Parameter

-AcquirePolicyToken

Rufen Sie automatisch ein Azure Policy Token für diesen Ressourcenvorgang ab.

Parametereigenschaften

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

Parametersätze

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

-CertificateFile

Gibt den Pfad der PFX-Datei des von diesem Cmdlet erstellten SSL-Zertifikats an.

Parametereigenschaften

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

Parametersätze

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

-ChangeReference

Die Änderungsreferenzressourcen-ID für diesen Ressourcenvorgang.

Parametereigenschaften

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

Parametersätze

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

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

-HsmKeyId

Schlüsselkennung eines Schlüssels, der im verwalteten HSM gespeichert ist.

Parametereigenschaften

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

Parametersätze

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

-HsmPublicCertData

Base64-codierte öffentliche Zertifikatdaten, die dem in verwalteten HSM gespeicherten Schlüssel entsprechen.

Parametereigenschaften

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

Parametersätze

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

-KeyVaultSecretId

SecretId (uri) des Schlüsselschlüsselschlüssels. Verwenden Sie diese Option, wenn eine bestimmte Version des geheimen Schlüssels verwendet werden muss.

Parametereigenschaften

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

Parametersätze

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

-Name

Gibt den Namen des von diesem Cmdlet erstellten SSL-Zertifikats an.

Parametereigenschaften

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

Parametersätze

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

-Password

Gibt das Kennwort des von diesem Cmdlet erstellten SSL an.

Parametereigenschaften

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

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
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.

Eingaben

None

Ausgaben

PSApplicationGatewaySslCertificate