Partilhar via


Set-AzApiManagementNamedValue

Modifica um valor nomeado de gerenciamento de API.

Sintaxe

Set-AzApiManagementNamedValue
   -Context <PsApiManagementContext>
   -NamedValueId <String>
   [-Name <String>]
   [-Value <String>]
   [-Secret <Boolean>]
   [-Tag <String[]>]
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-AzApiManagementNamedValue modifica um Valor Nomeado de Gerenciamento de API do Azure.

Exemplos

Exemplo 1: Alterar as tags no valor nomeado

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

O primeiro comando atribui dois valores à variável $Tags. O segundo comando modifica o valor nomeado que tem a ID Property11. O comando atribui as cadeias de caracteres em $Tags como tags no valor nomeado.

Exemplo 2: Modificar o valor nomeado para ter um valor secreto

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementNamedValue -Context $apimContext -NamedValueId "Property12" -Secret $True -PassThru

Este comando altera o valor nomeado para ser criptografado.

Exemplo 3

Modifica um valor nomeado de gerenciamento de API. (gerado automaticamente)

Set-AzApiManagementNamedValue -Context <PsApiManagementContext> -Name 'ContosoApi' -NamedValueId 'Property11' -Secret $true -Tag <String[]> -Value 'Property Value'

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

-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 é opcional.

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

-NamedValueId

Identificador do valor nomeado a ser atualizado. Este parâmetro é obrigatório.

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

-PassThru

Se especificado, o tipo de instância de Microsoft.Azure.Commands.ApiManagement.ServiceManagement.Models.PsApiManagementProperty que representa a propriedade modificada será gravado na saída.

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

-Secret

Se o valor nomeado é um segredo e seu valor deve ser criptografado. Este parâmetro é opcional.

Tipo:Nullable<T>[Boolean]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Tag

Tags 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 é opcional.

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

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

String[]

SwitchParameter

Saídas

PsApiManagementNamedValue