Compartir a través de

New-AzApiManagementNamedValue

  • Referencia
Módulo:
Az.ApiManagement

Crea un nuevo valor con nombre.

Sintaxis

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

Description

El cmdlet New-AzApiManagementNamedValue crea un Valor con nombreazure API Management.

Ejemplos

Ejemplo 1: Crear un valor con nombre que incluya etiquetas

$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

El primer comando asigna dos valores a la variable $Tags. El segundo comando crea un valor con nombre y asigna las cadenas de $Tags como etiquetas en la propiedad .

Ejemplo 2: Crear un valor con nombre que tenga un 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 crea un valor con nombre que tiene un valor cifrado.

Ejemplo 3: Creación de un valor con nombre de keyVault

$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

El primer comando crea un almacén de claves. El segundo comando crea un valor con nombre mediante el secreto de este almacén de claves.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Context

Instancia de PsApiManagementContext. Este parámetro es obligatorio.

Tipo:PsApiManagementContext
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-KeyVault

KeyVault se usa para capturar datos Namedvalue. Este parámetro es necesario si no se especifica Value. Consulte New-AzApiManagementKeyVaultObject para obtener más información.

Tipo:PsApiManagementKeyVaultEntity
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Nombre del valor con nombre. La longitud máxima es de 100 caracteres. Solo puede contener letras, dígitos, punto, guion y caracteres de subrayado. Este parámetro es obligatorio.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-NamedValueId

Identificador del nuevo valor con nombre. Este parámetro es opcional. Si no se especifica, se generará.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Secret

Determina si el valor es un secreto y debe cifrarse o no. Este parámetro es opcional. El valor predeterminado es false.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Tag

Etiquetas que se van a asociar con el valor con nombre. Este parámetro es opcional.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Value

Valor del valor con nombre. Puede contener expresiones de directiva. La longitud máxima es de 1000 caracteres. Puede que no esté vacío o que solo esté formado por espacios en blanco. Este parámetro es obligatorio.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String[]

Salidas