New-AzApplicationGatewaySslCertificate

モジュール:
Az.Network Module

Azure アプリケーション ゲートウェイの SSL 証明書を作成します。

構文

Default (既定) 

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

説明

New-AzApplicationGatewaySslCertificate コマンドレットは、Azure アプリケーション ゲートウェイの SSL 証明書を作成します。

例

例 1: Azure アプリケーション ゲートウェイの SSL 証明書を作成する。

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

このコマンドは、既定のアプリケーション ゲートウェイの Cert01 という名前の SSL 証明書を作成し、結果を $Cert という名前の変数に格納します。

例 2: KeyVault シークレット (バージョンレス secretId) を使用して SSL 証明書を作成し、アプリケーション ゲートウェイに追加します。

$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 がここに用意されているため、Application Gateway は証明書を KeyVault と定期的に同期します。

例 3: KeyVault シークレットを使用して SSL 証明書を作成し、Application Gateway に追加する。

$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 証明書を作成します。 注: Application Gateway が証明書を KeyVault と同期する必要がある場合は、バージョンレスの secretId を指定してください。

例 4: Managed HSM を使用して SSL 証明書を作成し、アプリケーション ゲートウェイに追加する。

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

New-AzApplicationGatewaySslCertificateを使用して、Managed HSM に格納されているキーを参照する SSL 証明書を作成します。

パラメーター

-AcquirePolicyToken

このリソース操作のAzure Policy トークンを自動的に取得します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-CertificateFile

このコマンドレットで作成する SSL 証明書の .pfx ファイルのパスを指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ChangeReference

このリソース操作の変更参照リソース ID。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-HsmKeyId

マネージドHSMに保存された鍵の鍵識別子。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-HsmPublicCertData

Managed HSM に格納されているキーに対応する Base-64 でエンコードされた公開証明書データ。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-KeyVaultSecretId

KeyVault シークレットの SecretId (uri)。 このオプションは、特定のバージョンのシークレットを使用する必要がある場合に使用します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

このコマンドレットで作成する SSL 証明書の名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Password

このコマンドレットで作成する SSL のパスワードを指定します。

パラメーターのプロパティ

型:SecureString
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。

入力

None

出力

PSApplicationGatewaySslCertificate