你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Enable-AzFrontDoorCustomDomainHttps

参考

模块:: Az.FrontDoor

使用 Front Door 托管证书或使用 Azure 密钥库中的自己的证书为自定义域启用 HTTPS。

语法

Enable-AzFrontDoorCustomDomainHttps
      -ResourceGroupName <String>
      -FrontDoorName <String>
      -FrontendEndpointName <String>
      [-MinimumTlsVersion <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Enable-AzFrontDoorCustomDomainHttps
      -ResourceGroupName <String>
      -FrontDoorName <String>
      -FrontendEndpointName <String>
      -VaultId <String>
      -SecretName <String>
      [-SecretVersion <String>]
      [-MinimumTlsVersion <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Enable-AzFrontDoorCustomDomainHttps
      -ResourceId <String>
      [-MinimumTlsVersion <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Enable-AzFrontDoorCustomDomainHttps
      -ResourceId <String>
      -VaultId <String>
      -SecretName <String>
      [-SecretVersion <String>]
      [-MinimumTlsVersion <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Enable-AzFrontDoorCustomDomainHttps
      -InputObject <PSFrontendEndpoint>
      [-MinimumTlsVersion <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Enable-AzFrontDoorCustomDomainHttps
      -InputObject <PSFrontendEndpoint>
      -VaultId <String>
      -SecretName <String>
      [-SecretVersion <String>]
      [-MinimumTlsVersion <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Enable-AzFrontDoorCustomDomainHttps 为自定义域启用 HTTPS。

示例

示例 1：使用 Front Door 托管证书为具有 FrontDoorName 和 ResourceGroupName 的自定义域启用 HTTPS。

Enable-AzFrontDoorCustomDomainHttps -ResourceGroupName "resourcegroup1" -FrontDoorName "frontdoor1" -FrontendEndpointName "frontendpointname1-custom-xyz" -MinimumTlsVersion "1.2"

HostName                         : frontendpointname1.custom.xyz
SessionAffinityEnabledState      : Disabled
SessionAffinityTtlSeconds        : 0
WebApplicationFirewallPolicyLink :
Backends                         :
CustomHttpsProvisioningState     : Enabling
CustomHttpsProvisioningSubstate  : SubmittingDomainControlValidationRequest
CertificateSource                : FrontDoor
ProtocolType                     : ServerNameIndication
MinimumTlsVersion                : 1.2
Vault                            :
SecretName                       :
SecretVersion                    :
CertificateType                  :
ResourceState                    : Enabled
Id                               : /subscriptions/{guid}/resourcegroups/resourcegroup1
                                   /providers/Microsoft.Network/frontdoors/frontdoor1/frontendendpoints/frontendpointname1-custom-xyz
Name                             : frontendpointname1-custom-xyz
Type                             : Microsoft.Network/frontdoors/frontendendpoints

为使用 Front Door 托管证书的资源组“resourcegroup1”中的 Front Door“frontdoor1”的自定义域“frontendpointname1-custom-xyz”启用 HTTPS。

示例 2：在具有特定版本的密钥库中使用客户自己的证书为具有 FrontDoorName 和 ResourceGroupName 的自定义域启用 HTTPS。

$vaultId = (Get-AzKeyVault -VaultName $vaultName).ResourceId
Enable-AzFrontDoorCustomDomainHttps -ResourceGroupName "resourcegroup1" -FrontDoorName "frontdoor1" -FrontendEndpointName "frontendpointname1-custom-xyz" -VaultId $vaultId -secretName $secretName -SecretVersion $secretVersion -MinimumTlsVersion "1.0"

HostName                         : frontendpointname1.custom.xyz
SessionAffinityEnabledState      : Disabled
SessionAffinityTtlSeconds        : 0
WebApplicationFirewallPolicyLink :
Backends                         :
CustomHttpsProvisioningState     : Enabling
CustomHttpsProvisioningSubstate  : SubmittingDomainControlValidationRequest
CertificateSource                : AzureKeyVault
ProtocolType                     : ServerNameIndication
MinimumTlsVersion                : 1.0
Vault                            :
SecretName                       :
SecretVersion                    :
CertificateType                  :
ResourceState                    : Enabled
Id                               : /subscriptions/{guid}/resourcegroups/resourcegroup1
                                   /providers/Microsoft.Network/frontdoors/frontdoor1/frontendendpoints/frontendpointname1-custom-xyz
Name                             : frontendpointname1-custom-xyz
Type                             : Microsoft.Network/frontdoors/frontendendpoints

为属于资源组“resourcegroup1”中的 Front Door“frontdoor1”的自定义域“frontendpointname1-custom-xyz”启用 HTTPS，该域在具有特定版本的密钥库中使用客户自己的证书。

示例 3：使用 Front Door 托管证书为具有 PSFrontendEndpoint 对象的自定义域启用 HTTPS。

Get-AzFrontDoorFrontendEndpoint -ResourceGroupName "resourcegroup1" -FrontDoorName "frontdoor1" -Name "frontendpointname1-custom-xyz" | Enable-AzFrontDoorCustomDomainHttps

HostName                         : frontendpointname1.custom.xyz
SessionAffinityEnabledState      : Disabled
SessionAffinityTtlSeconds        : 0
WebApplicationFirewallPolicyLink :
Backends                         :
CustomHttpsProvisioningState     : Enabling
CustomHttpsProvisioningSubstate  : SubmittingDomainControlValidationRequest
CertificateSource                : FrontDoor
ProtocolType                     : ServerNameIndication
MinimumTlsVersion                : 1.2
Vault                            :
SecretName                       :
SecretVersion                    :
CertificateType                  :
ResourceState                    : Enabled
Id                               : /subscriptions/{guid}/resourcegroups/resourcegroup1
                                   /providers/Microsoft.Network/frontdoors/frontdoor1/frontendendpoints/frontendpointname1-custom-xyz
Name                             : frontendpointname1-custom-xyz
Type                             : Microsoft.Network/frontdoors/frontendendpoints

使用 Front Door 托管证书为具有 PSFrontendEndpoint 对象的自定义域启用 HTTPS。

示例 4：使用 Front Door 托管证书为具有资源 ID 的自定义域启用 HTTPS。

Enable-AzFrontDoorCustomDomainHttps -ResourceId $resourceId

HostName                         : frontendpointname1.custom.xyz
SessionAffinityEnabledState      : Disabled
SessionAffinityTtlSeconds        : 0
WebApplicationFirewallPolicyLink :
Backends                         :
CustomHttpsProvisioningState     : Enabling
CustomHttpsProvisioningSubstate  : SubmittingDomainControlValidationRequest
CertificateSource                : FrontDoor
ProtocolType                     : ServerNameIndication
MinimumTlsVersion                : 1.2
Vault                            :
SecretName                       :
SecretVersion                    :
CertificateType                  :
ResourceState                    : Enabled
Id                               : /subscriptions/{guid}/resourcegroups/resourcegroup1
                                   /providers/Microsoft.Network/frontdoors/frontdoor1/frontendendpoints/frontendpointname1-custom-xyz
Name                             : frontendpointname1-custom-xyz
Type                             : Microsoft.Network/frontdoors/frontendendpoints

为使用 Front Door 托管证书$resourceId资源 ID 的自定义域“frontendpointname1-custom-xyz”启用 HTTPS。

示例 5：使用 FrontDoorName 和 ResourceGroupName 的自定义域启用 HTTPS，并在具有最新版本的密钥库中使用客户自己的证书启用证书自动轮换。

$vaultId = (Get-AzKeyVault -VaultName $vaultName).ResourceId
Enable-AzFrontDoorCustomDomainHttps -ResourceGroupName "resourcegroup1" -FrontDoorName "frontdoor1" -FrontendEndpointName "frontendpointname1-custom-xyz" -VaultId $vaultId -secretName $secretName -MinimumTlsVersion "1.0"

HostName                         : frontendpointname1.custom.xyz
SessionAffinityEnabledState      : Disabled
SessionAffinityTtlSeconds        : 0
WebApplicationFirewallPolicyLink :
Backends                         :
CustomHttpsProvisioningState     : Enabling
CustomHttpsProvisioningSubstate  : SubmittingDomainControlValidationRequest
CertificateSource                : AzureKeyVault
ProtocolType                     : ServerNameIndication
MinimumTlsVersion                : 1.0
Vault                            :
SecretName                       :
SecretVersion                    :
CertificateType                  :
ResourceState                    : Enabled
Id                               : /subscriptions/{guid}/resourcegroups/resourcegroup1
                                   /providers/Microsoft.Network/frontdoors/frontdoor1/frontendendpoints/frontendpointname1-custom-xyz
Name                             : frontendpointname1-custom-xyz
Type                             : Microsoft.Network/frontdoors/frontendendpoints

在资源组“resourcegroup1”中为属于 Front Door“frontdoor1”的自定义域“frontendpointname1-custom-xyz”启用 HTTPS，该域使用客户自己的证书在具有最新版本的密钥库启用证书自动轮换。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
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

-FrontDoorName

Front Door 的名称。

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

-FrontendEndpointName

前端终结点名称。

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

-InputObject

要更新的前端终结点对象。

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

-MinimumTlsVersion

客户端建立与 Front Door 的 SSL 握手所需的最低 TLS 版本。

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

-ResourceGroupName

Front Door 所属的资源组。

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

-ResourceId

用于启用 https 的 Front Door 终结点的资源 ID

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

-SecretName

表示完整证书 PFX 的 Key Vault 机密的名称

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

-SecretVersion

表示完整证书 PFX 的密钥库机密的版本。如果未指定，则始终使用“最新”版本，并且部署的证书将在较新版本的证书可用时自动轮换到最新版本。

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

-VaultId

包含 SSL 证书的密钥库 ID

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

String

输出

PSFrontendEndpoint

通过

Enable-AzFrontDoorCustomDomainHttps

语法

说明

示例

示例 1：使用 Front Door 托管证书为具有 FrontDoorName 和 ResourceGroupName 的自定义域启用 HTTPS。

示例 2：在具有特定版本的密钥库中使用客户自己的证书为具有 FrontDoorName 和 ResourceGroupName 的自定义域启用 HTTPS。

示例 3：使用 Front Door 托管证书为具有 PSFrontendEndpoint 对象的自定义域启用 HTTPS。

示例 4：使用 Front Door 托管证书为具有资源 ID 的自定义域启用 HTTPS。

示例 5：使用 FrontDoorName 和 ResourceGroupName 的自定义域启用 HTTPS，并在具有最新版本的密钥库中使用客户自己的证书启用证书自动轮换。

参数

-Confirm

-DefaultProfile

-FrontDoorName

-FrontendEndpointName

-InputObject

-MinimumTlsVersion

-ResourceGroupName

-ResourceId

-SecretName

-SecretVersion

-VaultId

-WhatIf

输入

输出

其他资源

通过

Enable-AzFrontDoorCustomDomainHttps

语法

说明

示例

示例 1：使用 Front Door 托管证书为具有 FrontDoorName 和 ResourceGroupName 的自定义域启用 HTTPS。

示例 2：在具有特定版本的 密钥库中使用客户自己的证书为具有 FrontDoorName 和 ResourceGroupName 的自定义域启用 HTTPS。

示例 3：使用 Front Door 托管证书为具有 PSFrontendEndpoint 对象的自定义域启用 HTTPS。

示例 4：使用 Front Door 托管证书为具有资源 ID 的自定义域启用 HTTPS。

示例 5：使用 FrontDoorName 和 ResourceGroupName 的自定义域启用 HTTPS，并在具有最新版本的 密钥库 中使用客户自己的证书启用证书自动轮换。

参数

-Confirm

-DefaultProfile

-FrontDoorName

-FrontendEndpointName

-InputObject

-MinimumTlsVersion

-ResourceGroupName

-ResourceId

-SecretName

-SecretVersion

-VaultId

-WhatIf

输入

输出

其他资源

示例 2：在具有特定版本的密钥库中使用客户自己的证书为具有 FrontDoorName 和 ResourceGroupName 的自定义域启用 HTTPS。

示例 5：使用 FrontDoorName 和 ResourceGroupName 的自定义域启用 HTTPS，并在具有最新版本的密钥库中使用客户自己的证书启用证书自动轮换。