New-AzApiManagementCustomHostnameConfiguration

Модуль:

Az.ApiManagement

Создает экземпляр 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>]

Описание

Командлет New-AzApiManagementCustomHostnameConfiguration является вспомогательной командой, которая создает экземпляр PsApiManagementCustomHostNameConfiguration. Эта команда используется с командлетом New-AzApiManagement и Set-AzApiManagement.

Примеры

Пример 1. Создание и инициализация экземпляра PsApiManagementCustomHostNameConfiguration с помощью ssl-сертификата из файла

$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. Создание и инициализация экземпляра PsApiManagementCustomHostNameConfiguration с помощью секрета из ресурса 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

Эта команда создает и инициализирует экземпляр psApiManagementCustomHostNameConfiguration.

Параметры

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Тип:	IAzureContextContainer
Aliases:	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

User-Assigned Идентификатор клиента управляемого удостоверения, используемый для проверки подлинности в KeyVault для получения пользовательского SSL-сертификата.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-KeyVaultId

KeyVaultId к секрету, в котором хранится пользовательский SSL-сертификат.

Тип:	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

Связанные ссылки

• New-AzApiManagement
• Set-AzApiManagement