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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Instancia de PsApiManagementContext. Este parámetro es obligatorio.
Type: | PsApiManagementContext |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | 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.
Type: | PsApiManagementKeyVaultEntity |
Position: | Named |
Default value: | None |
Required: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | 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á.
Type: | String |
Position: | Named |
Default value: | None |
Required: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | 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.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
String[]