New-AzApiManagementNamedValue
Crea un nuevo valor con nombre.
Syntax
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 nombre de Azure 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 solicita su confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Instancia de PsApiManagementContext. Este parámetro es obligatorio.
Tipo: | PsApiManagementContext |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Nombre del valor con nombre. La longitud máxima es de 100 caracteres. Puede contener solo letras, dígitos, puntos, guiones o caracteres de subrayado. Este parámetro es obligatorio.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NamedValueId
Identificador del nuevo valor con nombre. Este parámetro es opcional. Si no se especifica, se generará.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Secret
Determina si el valor es secreto y si se debe cifrar. Este parámetro es opcional. El valor predeterminado es false.
Tipo: | SwitchParameter |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Etiquetas que se van a asociar con el valor con nombre. Este parámetro es opcional.
Tipo: | String[] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Value
Valor del valor con nombre. Puede contener expresiones de directiva. La longitud máxima es de 1000 caracteres. No puede estar vacío ni contener solo espacios en blanco. Este parámetro es obligatorio.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
String[]
Salidas
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de