Add-FnFindInMap

Add-FnFindInMap

SYNOPSIS

Adds the intrinsic function “Fn::FindInMap” to a resource property

SYNTAX

Add-FnFindInMap [-MapName] <Object> [-TopLevelKey] <Object> [-SecondLevelKey] <Object> [<CommonParameters>]

DESCRIPTION

The intrinsic function Fn::FindInMap returns the value corresponding to keys in a two-level map that is declared in the Mappings section.

EXAMPLES

EXAMPLE 1

Add-FnFindInMap -MapName "RegionMap" -TopLevelKey (Add-FnRef -Ref "$_AWSRegion") -SecondLevelKey "32"

When the template is exported, this will convert to: {“Fn::FindInMap”:[“RegionMap”,{“Ref”:”AWS::Region”},”32”]}

PARAMETERS

-MapName

The logical name of a mapping declared in the Mappings section that contains the keys and values. The value can be another function.

Type: Object
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TopLevelKey

The top-level key name. Its value is a list of key-value pairs. The value can be another function.

Type: Object
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SecondLevelKey

The second-level key name, which is set to one of the keys from the list assigned to TopLevelKey. The value can be another function.

Type: Object
Parameter Sets: (All)
Aliases:

Required: True
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

Vaporshell.Function.FindInMap

NOTES

You can use the following functions in a Fn::FindInMap function: Fn::FindInMap Ref

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-findinmap.html