New-AzApiManagementNamedValue

Referência

Módulo:: Az.ApiManagement

Cria um novo Valor Nomeado.

Sintaxe

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

Description

O cmdlet New-AzApiManagementNamedValue cria um Valor Nomeado de Gerenciamento de API do Azure.

Exemplos

Exemplo 1: Criar um valor nomeado que inclua tags

$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

O primeiro comando atribui dois valores à variável $Tags. O segundo comando cria um valor nomeado e atribui as cadeias de caracteres em $Tags como tags na propriedade.

Exemplo 2: Criar um valor nomeado que tenha um valor secreto

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

Este comando cria um Valor Nomeado que tem um valor que é criptografado.

Exemplo 3: Criar um 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

O primeiro comando cria um keyvault. O segundo comando cria um valor nomeado usando secret deste keyvault.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Context

Instância de PsApiManagementContext. Este parâmetro é obrigatório.

Tipo:	PsApiManagementContext
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-KeyVault

KeyVault usado para buscar dados Namedvalue. Este parâmetro é necessário se Value não for especificado. Consulte New-AzApiManagementKeyVaultObject para obter detalhes.

Tipo:	PsApiManagementKeyVaultEntity
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Name

Nome do valor nomeado. O comprimento máximo é de 100 caracteres. Pode conter apenas letras, dígitos, ponto, travessão e caracteres sublinhados. Este parâmetro é obrigatório.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-NamedValueId

Identificador do novo valor nomeado. Este parâmetro é opcional. Se não especificado será gerado.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Secret

Determina se o valor é um segredo e deve ser criptografado ou não. Este parâmetro é opcional. O valor padrão é false.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Tag

Tags a serem associadas ao valor nomeado. Este parâmetro é opcional.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Value

Valor do valor nomeado. Pode conter expressões de política. O comprimento máximo é de 1000 caracteres. Não pode estar vazio ou consistir apenas em espaço em branco. Este parâmetro é obrigatório.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

PsApiManagementContext

String

SwitchParameter

String[]

Saídas

PsApiManagementNamedValue

Partilhar via