New-AzApplicationGatewaySslCertificate

建立 Azure 應用程式閘道的 SSL 憑證。

Syntax

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

Description

New-AzApplicationGatewaySslCertificate Cmdlet 會為 Azure 應用程式閘道建立 SSL 憑證。

範例

範例 1:建立 Azure 應用程式閘道的 SSL 憑證。

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

此命令會為預設應用程式閘道建立名為 Cert01 的 SSL 憑證,並將結果儲存在名為 $Cert 的變數中。

範例 2:使用 KeyVault Secret 建立 SSL 憑證(無版本 secretId),並新增至應用程式閘道。

$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

取得秘密,並使用 New-AzApplicationGatewaySslCertificate建立 SSL 憑證。 注意:此處提供無版本 secretId 時,應用程式閘道 會定期同步處理憑證與 KeyVault。

範例 3:使用 KeyVault Secret 建立 SSL 憑證,並將 新增至 應用程式閘道。

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

取得秘密,並使用 New-AzApplicationGatewaySslCertificate建立 SSL 憑證。 注意:如果需要 應用程式閘道 將憑證與 KeyVault 同步處理,請提供無版本 secretId。

參數

-CertificateFile

指定這個 Cmdlet 所建立之 SSL 憑證之 .pfx 檔案的路徑。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyVaultSecretId

KeyVault Secret 的 SecretId (uri)。 當需要使用特定版本的秘密時,請使用此選項。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定此 Cmdlet 建立的 SSL 憑證名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Password

指定此 Cmdlet 所建立之 SSL 的密碼。

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

None

輸出

PSApplicationGatewaySslCertificate