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