Condividi tramite

New-AzApiManagementCustomHostnameConfiguration

  • Riferimento
Modulo:
Az.ApiManagement

Crea un'istanza di PsApiManagementCustomHostNameConfiguration.

Sintassi

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>]

Descrizione

Il cmdlet New-AzApiManagementCustomHostnameConfiguration è un comando helper che crea un'istanza di PsApiManagementCustomHostNameConfiguration. Questo comando viene usato con il cmdlet New-AzApiManagement e Set-AzApiManagement.

Esempio

Esempio 1: Creare e inizializzare un'istanza di PsApiManagementCustomHostNameConfiguration usando un certificato SSL dal file

$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

Questo comando crea e inizializza un'istanza di PsApiManagementCustomHostNameConfiguration per il portale. Crea quindi un nuovo servizio ApiManagement con la configurazione del nome host personalizzato.

Esempio 2: Creare e inizializzare un'istanza di PsApiManagementCustomHostNameConfiguration usando un segreto dalla risorsa 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

Questo comando crea e inizializza un'istanza di PsApiManagementCustomHostNameConfiguration.

Parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultSslBinding

Determina se il valore è un segreto e deve essere crittografato o meno. Questo parametro è facoltativo. Il valore predefinito è false.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Hostname

Nome host personalizzato

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-HostNameCertificateInformation

Configurazione del certificato esistente.

Tipo:PsApiManagementCertificateInformation
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-HostnameType

Tipo nome host

Tipo:PsApiManagementHostnameType
Valori accettati:Proxy, Portal, Management, Scm, DeveloperPortal, Configuration, Data
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IdentityClientId

User-Assigned Id client dell'identità gestita usato per eseguire l'autenticazione a KeyVault per recuperare il certificato SSL personalizzato.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-KeyVaultId

KeyVaultId nel segreto in cui è archiviato il certificato SSL personalizzato.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ManagedCertificate

Determina se si vuole effettuare il provisioning di un certificato gestito la cui rotazione è gestita dalla piattaforma

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NegotiateClientCertificate

Determina se il valore è un segreto e deve essere crittografato o meno. Questo parametro è facoltativo. Il valore predefinito è false.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PfxPassword

Password per il file di certificato pfx.

Tipo:SecureString
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PfxPath

Percorso di un file di certificato con estensione pfx.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Output