Aracılığıyla paylaş

New-AzApiManagementCustomHostnameConfiguration

  • Başvuru
Modül:
Az.ApiManagement

öğesinin bir örneğini PsApiManagementCustomHostNameConfigurationoluşturur.

Sözdizimi

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

New-AzApiManagementCustomHostnameConfiguration cmdlet'i, PsApiManagementCustomHostNameConfiguration örneğini oluşturan bir yardımcı komutdur. Bu komut New-AzApiManagement ve Set-AzApiManagement cmdlet'iyle kullanılır.

Örnekler

Örnek 1: Dosyadan ssl sertifikası kullanarak PsApiManagementCustomHostNameConfiguration örneği oluşturma ve başlatma

$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

Bu komut, Portal için bir PsApiManagementCustomHostNameConfiguration örneği oluşturur ve başlatır. Ardından özel konak adı yapılandırmasına sahip yeni bir ApiManagement hizmeti oluşturur.

Örnek 2: KeyVault Kaynağından Gizli Dizi kullanarak PsApiManagementCustomHostNameConfiguration örneği oluşturma ve başlatma

$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

Bu komut bir PsApiManagementCustomHostNameConfiguration örneği oluşturur ve başlatır.

Parametreler

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultSslBinding

Değerin gizli dizi olup olmadığını ve şifrelenip şifrelenmemesi gerektiğini belirler. Bu parametre isteğe bağlıdır. Varsayılan Değer false'tur.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Hostname

Özel Ana Bilgisayar Adı

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HostNameCertificateInformation

Mevcut Sertifika Yapılandırması.

Tür:PsApiManagementCertificateInformation
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-HostnameType

Ana Bilgisayar Adı Türü

Tür:PsApiManagementHostnameType
Kabul edilen değerler:Proxy, Portal, Management, Scm, DeveloperPortal, Configuration, Data
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IdentityClientId

Özel SSL Sertifikası getirmek için KeyVault'ta kimlik doğrulaması yapmak için kullanılan Kullanıcı Tarafından Atanan Yönetilen Kimlik İstemci Kimliği.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-KeyVaultId

Özel SSL Sertifikasını depolayarak gizli diziye KeyVaultId.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ManagedCertificate

Döndürmesi platform tarafından yönetilen bir yönetilen sertifika sağlamak isteyip istemediğinizi belirler

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-NegotiateClientCertificate

Değerin gizli dizi olup olmadığını ve şifrelenip şifrelenmemesi gerektiğini belirler. Bu parametre isteğe bağlıdır. Varsayılan Değer false'tur.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PfxPassword

.pfx sertifika dosyasının parolası.

Tür:SecureString
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PfxPath

.pfx sertifika dosyasının yolu.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

PsApiManagementCertificateInformation

Çıkışlar

PsApiManagementCustomHostNameConfiguration