< Back

Update-EdgeKvm

Sun Jan 19, 2020 6:05 pm

NAME Update-EdgeKvm



SYNOPSIS

Update a key-value map in Apigee Edge.





SYNTAX

Update-EdgeKvm [-Name] <String> [[-Values] <Hashtable>] [[-Source] <String>] [[-Environment] <String>] [[-Proxy]

<String>] [[-Org] <String>] [<CommonParameters>]





DESCRIPTION

Update a key-value map in Apigee Edge, with all new values. All of the existing values will be removed.

The KVM must exist.





PARAMETERS

-Name <String>

The name of the key-value map to update.



Required? true

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Values <Hashtable>

Required. A hashtable specifying key/value pairs. Use in lieu of the -Source option.

Example:

@{

key1 = 'value1'

key2 = 'value2'

}



Required? false

Position? 2

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Source <String>

Optional. A file containing JSON that specifis key/value pairs. Use in

lieu of the -Values option. Example contents:

{

"key1" : "value1",

"key2" : "value2"

}



Required? false

Position? 3

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Environment <String>

Optional. A string, the name of the environment in Apigee Edge with which the keyvalue

map is associated. KVMs can be associated to an organization, an environment, or an

API Proxy. If you specify neither Environment nor Proxy, the default is to resolve the name of

the KVM in the list of organization-wide Key-Value Maps.



Required? false

Position? 4

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Proxy <String>

Optional. The API Proxy within Apigee Edge with which the keyvalue map is

associated. KVMs can be associated to an organization, an environment, or an API

Proxy. If you specify neither Environment nor Proxy, the default is to resolve the name of the

KVM in the list of organization-wide Key-Value Maps.



Required? false

Position? 5

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Org <String>

Optional. The Apigee Edge organization. The default is to use the value from Set-EdgeConnection.



Required? false

Position? 6

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Update-EdgeKvm -Name kvm101 -Environment test -Values @{ key1 = 'value1'; key2 = 'value2' }













-------------------------- EXAMPLE 2 --------------------------



PS C:\\>Update-EdgeKvm -Name kvm101 -Environment test -Source .\\myfile.json















RELATED LINKS