다음을 통해 공유


New-AzApiManagementCustomHostnameConfiguration

PsApiManagementCustomHostNameConfiguration의 인스턴스를 만듭니다.

구문

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은 PsApiManagementCustomHostNameConfiguration 인스턴스를 만드는 도우미 명령입니다. 이 명령은 New-AzApiManagement 및 Set-AzApiManagement cmdlet과 함께 사용됩니다.

예제

예제 1: 파일의 Ssl 인증서를 사용하여 PsApiManagementCustomHostNameConfiguration 인스턴스 만들기 및 초기화

$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

이 명령은 포털용 PsApiManagementCustomHostNameConfiguration 인스턴스를 만들고 초기화합니다. 그런 다음 사용자 지정 호스트 이름 구성을 사용하여 새 ApiManagement 서비스를 만듭니다.

예제 2: KeyVault 리소스의 비밀을 사용하여 PsApiManagementCustomHostNameConfiguration 인스턴스 만들기 및 초기화

$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

이 명령은 PsApiManagementCustomHostNameConfiguration 인스턴스 를 만들고 초기화합니다.

매개 변수

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultSslBinding

값이 암호인지, 그리고 암호화해야 하는지 여부를 결정합니다. 이 매개 변수는 선택 사항입니다. 기본값은 false입니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Hostname

사용자 지정 호스트 이름

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-HostNameCertificateInformation

기존 인증서 구성입니다.

형식:PsApiManagementCertificateInformation
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-HostnameType

호스트 이름 형식

형식:PsApiManagementHostnameType
허용되는 값:Proxy, Portal, Management, Scm, DeveloperPortal, Configuration, Data
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IdentityClientId

사용자 지정 SSL 인증서를 가져오기 위해 KeyVault에 인증하는 데 사용되는 사용자 할당 관리 ID ClientId입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-KeyVaultId

사용자 지정 SSL 인증서를 저장하는 비밀에 대한 KeyVaultId입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ManagedCertificate

플랫폼에서 회전을 관리하는 관리되는 인증서를 프로비전할지 여부를 결정합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NegotiateClientCertificate

값이 암호인지, 그리고 암호화해야 하는지 여부를 결정합니다. 이 매개 변수는 선택 사항입니다. 기본값은 false입니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PfxPassword

.pfx 인증서 파일의 암호입니다.

형식:SecureString
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PfxPath

.pfx 인증서 파일의 경로입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

PsApiManagementCertificateInformation

출력

PsApiManagementCustomHostNameConfiguration