New-AzApiManagementNamedValue

Ссылка

Модуль:: Az.ApiManagement

Создает новое именованное значение.

Синтаксис

New-AzApiManagementNamedValue
   -Context <PsApiManagementContext>
   [-NamedValueId <String>]
   [-Name <String>]
   [-Value <String>]
   [-Secret]
   [-Tag <String[]>]
   [-KeyVault <PsApiManagementKeyVaultEntity>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет New-AzApiManagementNamedValue создает azure Управление API именованное значение.

Примеры

Пример 1. Создание именованного значения, включающего теги

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
$Tags = 'sdk', 'powershell'
New-AzApiManagementNamedValue -Context $apimContext -NamedValueId "Property11" -Name "Property Name" -Value "Property Value" -Tag $Tags

Первая команда назначает два значения переменной $Tags. Вторая команда создает именованное значение и назначает строки в $Tags в качестве тегов в свойстве.

Пример 2. Создание именованного значения с секретным значением

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
New-AzApiManagementNamedValue -Context $apimContext -NamedValueId "Property12" -Name "Secret Property" -Value "Secret Property Value" -Secret

Эта команда создает именованное значение с зашифрованным значением .

Пример 3. Создание keyVault Namedvalue

$secretIdentifier = 'https://contoso.vault.azure.net/secrets/xxxx'
$keyvault = New-AzApiManagementKeyVaultObject -SecretIdentifier $secretIdentifier 
$keyVaultNamedValue = New-AzApiManagementNamedValue -Context $context -NamedValueId $keyVaultNamedValueId -Name $keyVaultNamedValueName -keyVault $keyvault -Secret

Первая команда создает ключи. Вторая команда создает именованное значение с помощью секрета из этого keyvault.

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Context

Экземпляр PsApiManagementContext. Этот параметр является обязательным.

Type:	PsApiManagementContext
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyVault

KeyVault используется для получения данных Именованного значения. Этот параметр требуется, если значение не указано. Дополнительные сведения см. в разделе New-AzApiManagementKeyVaultObject.

Type:	PsApiManagementKeyVaultEntity
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Имя именованного значения. Максимальная длина составляет 100 символов. Может содержать только буквы, цифры, точки, тире и знаки подчеркивания. Этот параметр является обязательным.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-NamedValueId

Идентификатор нового именованного значения. Это необязательный параметр. Если не указано, будет создано.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Secret

Определяет, является ли значение секретом и должно ли быть зашифровано. Это необязательный параметр. Значение по умолчанию равно false.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Теги, связанные с именованным значением. Это необязательный параметр.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Value

Значение именованного значения. Может содержать выражения политики. Максимальная длина составляет 1000 символов. Не может быть пустым или состоять только из пробелов. Этот параметр является обязательным.