Skip to main content

New-AMImageSet

SYNOPSIS​

Creates an ImageSet element for an Adaptive Card.

SYNTAX​

New-AMImageSet [-Images] <String[]> [[-AltText] <String>] [-ProgressAction <ActionPreference>]
 [<CommonParameters>]

DESCRIPTION​

The `New-AMImageSet` function creates an ImageSet element that displays a collection of images in a grid layout. ImageSets are useful when you need to show multiple related images together, such as product galleries, photo collections, or thumbnails.

The images are automatically arranged in a grid based on available space, and all images within the set share the same size. This ensures a consistent and visually appealing layout.

Each image in the set is represented by its URL, and all images share the same alternative text for accessibility.

EXAMPLES​

EXAMPLE 1​

# Create a simple image set with three images
$imageUrls = @(
    "https://example.com/product1.jpg",
    "https://example.com/product2.jpg",
    "https://example.com/product3.jpg"
)

$productGallery = New-AMImageSet -Images $imageUrls -AltText "Product Photos" Add-AMElement -Card $card -Element $productGallery

EXAMPLE 2​

# Create an image set from local files
$baseUrl = "https://storage.contoso.com/images/"
$fileNames = @("photo1.jpg", "photo2.jpg", "photo3.jpg", "photo4.jpg")
$imageUrls = $fileNames | ForEach-Object { $baseUrl + $_ }

$photoGallery = New-AMImageSet -Images $imageUrls -AltText "Vacation Photos" Add-AMElement -Card $card -Element $photoGallery

EXAMPLE 3​

# Create an image set with default alt text
$imageUrls = @(
    "https://example.com/image1.png",
    "https://example.com/image2.png"
)

$imageSet = New-AMImageSet -Images $imageUrls Add-AMElement -Card $card -Element $imageSet

PARAMETERS​

-Images​

An array of image URLs to include in the ImageSet. Each URL must point to a valid and accessible image file.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-AltText​

(Optional) Alternative text for the image set, providing a textual description for accessibility purposes. This alt text will be applied to all images in the set. Default: "Image Set"

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: Image Set
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction​

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
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​

None. You cannot pipe input to New-AMImageSet.​

OUTPUTS​

System.Collections.Hashtable​

Returns a hashtable representing the ImageSet element.​

NOTES​

  • ImageSets are designed to display collections of similarly-sized images.
  • For best results:
    • Use images of similar dimensions and aspect ratios.
    • Keep the number of images reasonable (4-8 is typically optimal).
    • Ensure all image URLs are publicly accessible.
  • Images in the set will be resized to fit the layout, so use high-quality images for best results.
  • Alt text is applied to all images in the set for accessibility purposes.

https://adaptivecards.io/explorer/ImageSet.html