New-AzApiManagementNamedValue

Referenz

Modul:: Az.ApiManagement

Erstellt einen neuen benannten Wert.

Syntax

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

Beschreibung

Das cmdlet New-AzApiManagementNamedValue erstellt ein Azure API Management Named Value.

Beispiele

Beispiel 1: Erstellen eines benannten Werts, der Tags enthält

$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

Der erste Befehl weist der variablen $Tags zwei Werte zu. Der zweite Befehl erstellt einen benannten Wert und weist die Zeichenfolgen in $Tags als Tags für die Eigenschaft zu.

Beispiel 2: Erstellen eines benannten Werts mit einem geheimen Wert

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
New-AzApiManagementNamedValue -Context $apimContext -NamedValueId "Property12" -Name "Secret Property" -Value "Secret Property Value" -Secret

Dieser Befehl erstellt einen benannten Wert mit einem verschlüsselten Wert.

Beispiel 3: Erstellen eines 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 -Secret

Der erste Befehl erstellt einen Keyvault. Der zweite Befehl erstellt einen benannten Wert mithilfe eines geheimen Schlüssels aus diesem Keyvault.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Context

Instanz von PsApiManagementContext. Dieser Parameter ist erforderlich.

Typ:	PsApiManagementContext
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-KeyVault

KeyVault zum Abrufen von Namedvalue-Daten. Dieser Parameter ist erforderlich, wenn "Value" nicht angegeben wurde. Weitere Informationen finden Sie unter New-AzApiManagementKeyVaultObject.

Typ:	PsApiManagementKeyVaultEntity
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Name

Name des benannten Werts. Die maximale Länge beträgt 100 Zeichen. Sie darf nur Buchstaben, Ziffern, Punkt, Gedankenstrich und Unterstriche enthalten. Dieser Parameter ist erforderlich.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-NamedValueId

Bezeichner des neuen benannten Werts. Dieser Parameter ist optional. Wenn nicht angegeben, wird dies generiert.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Secret

Bestimmt, ob der Wert ein Geheimschlüssel ist und verschlüsselt werden soll. Dieser Parameter ist optional. Der Standardwert ist "false".

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Tag

Tags, die mit benannten Werten verknüpft werden sollen. Dieser Parameter ist optional.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Value

Wert des benannten Werts. Kann Richtlinienausdrücke enthalten. Die maximale Länge beträgt 1000 Zeichen. Es darf nicht leer sein oder nur aus Leerzeichen bestehen. Dieser Parameter ist erforderlich.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

PsApiManagementContext

String

SwitchParameter

String[]

Ausgaben

PsApiManagementNamedValue

Freigeben über