Partilhar via

New-AzApiManagementCustomHostnameConfiguration

  • Referência
Módulo:
Az.ApiManagement

Cria uma instância de PsApiManagementCustomHostNameConfiguration.

Sintaxe

New-AzApiManagementCustomHostnameConfiguration
   -Hostname <String>
   -HostnameType <PsApiManagementHostnameType>
   -HostNameCertificateInformation <PsApiManagementCertificateInformation>
   [-DefaultSslBinding]
   [-NegotiateClientCertificate]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzApiManagementCustomHostnameConfiguration
   -Hostname <String>
   -HostnameType <PsApiManagementHostnameType>
   -PfxPath <String>
   [-PfxPassword <SecureString>]
   [-DefaultSslBinding]
   [-NegotiateClientCertificate]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzApiManagementCustomHostnameConfiguration
   -Hostname <String>
   -HostnameType <PsApiManagementHostnameType>
   -KeyVaultId <String>
   [-IdentityClientId <String>]
   [-DefaultSslBinding]
   [-NegotiateClientCertificate]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzApiManagementCustomHostnameConfiguration
   -Hostname <String>
   -HostnameType <PsApiManagementHostnameType>
   [-DefaultSslBinding]
   [-NegotiateClientCertificate]
   [-ManagedCertificate]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet New-AzApiManagementCustomHostnameConfiguration é um comando auxiliar que cria uma instância de PsApiManagementCustomHostNameConfiguration. Esse comando é usado com o cmdlet New-AzApiManagement e Set-AzApiManagement.

Exemplos

Exemplo 1: Criar e inicializar uma instância de PsApiManagementCustomHostNameConfiguration usando um certificado SSL do arquivo

$portal = New-AzApiManagementCustomHostnameConfiguration -Hostname "portal.contoso.com" -HostnameType Portal -PfxPath "C:\contoso\certificates\apimanagement.pfx" -PfxPassword "1111" -DefaultSslBinding
$customConfig = @($portal)
New-AzApiManagement -ResourceGroupName "ContosoGroup" -Location "West US" -Name "ContosoApi" -Organization Contoso -AdminEmail admin@contoso.com -CustomHostnameConfiguration $customConfig

Esse comando cria e inicializa uma instância de PsApiManagementCustomHostNameConfiguration para o Portal. Em seguida, ele cria um novo serviço ApiManagement com configuração de nome de host personalizado.

Exemplo 2: Criar e inicializar uma instância de PsApiManagementCustomHostNameConfiguration usando um segredo do recurso KeyVault

$portal = New-AzApiManagementCustomHostnameConfiguration -Hostname "portal.contoso.com" -HostnameType Portal -KeyVaultId "https://apim-test-keyvault.vault.azure.net/secrets/api-portal-custom-ssl.pfx"

$customConfig = @($portal)
New-AzApiManagement -ResourceGroupName "ContosoGroup" -Location "West US" -Name "ContosoApi" -Organization Contoso -AdminEmail admin@contoso.com -CustomHostnameConfiguration $customConfig -SystemAssignedIdentity

Esse comando cria e inicializa uma instância de PsApiManagementCustomHostNameConfiguration.

Parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultSslBinding

Determina se o valor é um segredo e se deve ser criptografado ou não. Esse parâmetro é opcional. O valor padrão é false.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Hostname

Nome do host personalizado

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-HostNameCertificateInformation

Configuração de certificado existente.

Tipo:PsApiManagementCertificateInformation
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-HostnameType

Tipo de nome de host

Tipo:PsApiManagementHostnameType
Valores aceitos:Proxy, Portal, Management, Scm, DeveloperPortal, Configuration, Data
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IdentityClientId

ClientId de identidade gerenciada atribuída pelo usuário usada para autenticar no KeyVault para buscar o certificado SSL personalizado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-KeyVaultId

KeyVaultId ao segredo que armazena o certificado SSL personalizado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ManagedCertificate

Determina se queremos provisionar um certificado gerenciado cuja rotação é gerenciada pela plataforma

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NegotiateClientCertificate

Determina se o valor é um segredo e se deve ser criptografado ou não. Esse parâmetro é opcional. O valor padrão é false.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PfxPassword

Senha para o arquivo de certificado .pfx.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PfxPath

Caminho para um arquivo de certificado .pfx.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PsApiManagementCertificateInformation

Saídas

PsApiManagementCustomHostNameConfiguration