Set-AzApplicationGatewaySslCertificate
Обновляет SSL-сертификат для шлюза приложений.
Синтаксис
Default (По умолчанию)
Set-AzApplicationGatewaySslCertificate
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-CertificateFile <String>]
[-Password <SecureString>]
[-KeyVaultSecretId <String>]
[-HsmKeyId <String>]
[-HsmPublicCertData <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Описание
Командлет Set-AzApplicationGatewaySslCertificate обновляет SSL-сертификат для шлюза приложений.
Примеры
Пример 1. Обновление существующего SSL-сертификата в шлюзе приложений
$appGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$password = ConvertTo-SecureString -String "****" -AsPlainText -Force
$cert = Set-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -CertificateFile "D:\cert01.pfx" -Password $password
Обновите существующий SSL-сертификат для шлюза приложений с именем ApplicationGateway01.
Пример 2. Обновление существующего SSL-сертификата с помощью KeyVault Secret (version-less secretId) в шлюзе приложений
$secret = Get-AzKeyVaultSecret -VaultName "keyvault01" -Name "sslCert01"
$secretId = $secret.Id.Replace($secret.Version, "") # https://<keyvaultname>.vault.azure.net/secrets/
$cert = Set-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -KeyVaultSecretId $secretId
Получите секрет и обновите существующий SSL-сертификат с помощью Set-AzApplicationGatewaySslCertificate.
Пример 3. Обновление существующего SSL-сертификата с помощью keyVault Secret в шлюзе приложений
$secret = Get-AzKeyVaultSecret -VaultName "keyvault01" -Name "sslCert01"
$secretId = $secret.Id # https://<keyvaultname>.vault.azure.net/secrets/<hash>
$cert = Set-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -KeyVaultSecretId $secretId
Получите секрет и обновите существующий SSL-сертификат с помощью Set-AzApplicationGatewaySslCertificate.
Примечание. Если требуется, чтобы шлюз приложений синхронизирул сертификат с KeyVault, укажите секретный идентификатор без версии.
Пример 4. Обновление существующего SSL-сертификата с помощью управляемого HSM в шлюзе приложений
$appGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$cert = Set-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -HsmKeyId "https://myhsm.managedhsm.azure.net/keys/mykey/abc123"
Обновите существующий SSL-сертификат, чтобы ссылаться на ключ, хранящийся в управляемом HSM.
Параметры
-AcquirePolicyToken
Автоматическое получение маркера Политика Azure для этой операции ресурса.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-ApplicationGateway
Указывает шлюз приложений, с которым связан сертификат SSL.
Свойства параметров
Тип: PSApplicationGateway
Значение по умолчанию: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: True Значение из конвейера: True Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-CertificateFile
Указывает путь к SSL-сертификату.
Свойства параметров
Тип: String
Значение по умолчанию: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-ChangeReference
Идентификатор ресурса ссылки на изменение для этой операции ресурса.
Свойства параметров
Тип: String
Значение по умолчанию: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Свойства параметров
Тип: IAzureContextContainer
Значение по умолчанию: None Поддерживаются подстановочные знаки: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-HsmKeyId
Идентификатор ключа ключа, хранящегося в управляемом HSM.
Свойства параметров
Тип: String
Значение по умолчанию: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-HsmPublicCertData
Данные общедоступного сертификата в кодировке Base-64, соответствующие ключу, хранящейся в управляемом HSM.
Свойства параметров
Тип: String
Значение по умолчанию: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-KeyVaultSecretId
SecretId (URI) секрета KeyVault. Используйте этот параметр, если требуется использовать определенную версию секрета.
Свойства параметров
Тип: String
Значение по умолчанию: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-Name
Указывает имя SSL-сертификата.
Свойства параметров
Тип: String
Значение по умолчанию: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: True Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-Password
Указывает пароль SSL-сертификата.
Свойства параметров
Тип: SecureString
Значение по умолчанию: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters .
Выходные данные
