New-AzApiManagementNamedValue
Crea un nuovo valore denominato.
Sintassi
New-AzApiManagementNamedValue
-Context <PsApiManagementContext>
[-NamedValueId <String>]
[-Name <String>]
[-Value <String>]
[-Secret]
[-Tag <String[]>]
[-KeyVault <PsApiManagementKeyVaultEntity>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Il cmdlet New-AzApiManagementNamedValue
Esempio
Esempio 1: Creare un valore denominato che include tag
$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 $TagsIl primo comando assegna due valori alla variabile $Tags. Il secondo comando crea un valore denominato e assegna le stringhe in $Tags come tag nella proprietà .
Esempio 2: Creare un valore denominato con un valore segreto
$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
New-AzApiManagementNamedValue -Context $apimContext -NamedValueId "Property12" -Name "Secret Property" -Value "Secret Property Value" -SecretQuesto comando crea un valore denominato con un valore crittografato.
Esempio 3: Creare un 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 -SecretIl primo comando crea un insieme di credenziali delle chiavi. Il secondo comando crea un valore denominato usando il segreto di questo insieme di credenziali delle chiavi.
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Context
Istanza di PsApiManagementContext. Questo parametro è obbligatorio.
| Tipo: | PsApiManagementContext |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
| Tipo: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-KeyVault
KeyVault usato per recuperare i dati Namedvalue. Questo parametro è obbligatorio se Value non è specificato. Per informazioni dettagliate, vedere New-AzApiManagementKeyVaultObject.
| Tipo: | PsApiManagementKeyVaultEntity |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Name
Nome del valore denominato. La lunghezza massima è di 100 caratteri. Può contenere solo lettere, cifre, punti, trattini e caratteri di sottolineatura. Questo parametro è obbligatorio.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-NamedValueId
Identificatore del nuovo valore denominato. Questo parametro è facoltativo. Se non specificato, verrà generato.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Secret
Determina se il valore è un segreto e deve essere crittografato o meno. Questo parametro è facoltativo. Il valore predefinito è false.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Tag
Tag da associare al valore denominato. Questo parametro è facoltativo.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Value
Valore del valore denominato. Può contenere espressioni di criteri. La lunghezza massima è di 1000 caratteri. Potrebbe non essere vuoto o costituito solo da spazi vuoti. Questo parametro è obbligatorio.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
String[]
