Skip to main content

New-AMImage

SYNOPSIS​

Creates an Image element for an Adaptive Card.

SYNTAX​

New-AMImage [-Url] <String> [[-AltText] <String>] [[-Size] <String>] [[-Style] <String>]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION​

The `New-AMImage` function creates an Image element that displays an image within an Adaptive Card. Images can be used to display logos, photos, icons, diagrams, or any visual content that enhances the card's appearance and information.

This function supports customization of image size, alternative text for accessibility, and style. Images should be hosted on publicly accessible servers to ensure they display correctly in all environments.

EXAMPLES​

EXAMPLE 1​

# Create a simple image
$logo = New-AMImage -Url "https://example.com/logo.png" -AltText "Company Logo"
Add-AMElement -Card $card -Element $logo

EXAMPLE 2​

# Create a large image with alt text
$banner = New-AMImage -Url "https://example.com/banner.jpg" -Size "large" -AltText "Product Banner"

EXAMPLE 3​

# Add an image to a container
$icon = New-AMImage -Url "https://example.com/icon.png" -Size "small" -AltText "Alert Icon"
$container = New-AMContainer -Id "alert-container" -Style "warning"

Add-AMElement -Card $card -Element $container Add-AMElement -Card $card -Element $icon -ContainerId "alert-container" Add-AMElement -Card $card -Element (New-AMTextBlock -Text "Warning: Action required") -ContainerId "alert-container"

EXAMPLE 4​

# Create a circular profile picture
$profilePicture = New-AMImage -Url "https://example.com/profile.jpg" -Style "person" -AltText "User Profile Picture"

PARAMETERS​

-Url​

The URL to the image. This must be a valid and accessible URL that points to the image file. This parameter is required.

Type: String
Parameter Sets: (All)
Aliases:

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

-AltText​

Alternative text for the image, which provides a textual description of the image for accessibility purposes or in cases where the image cannot be displayed.

Type: String
Parameter Sets: (All)
Aliases:

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

-Size​

Controls the size of the image. Valid values: "auto", "stretch", "small", "medium", "large" Default: "auto"

  • "auto": Automatically adjusts the size based on the image's natural dimensions.
  • "stretch": Stretches the image to fill the available space.
  • "small", "medium", "large": Predefined sizes for consistent rendering.
Type: String
Parameter Sets: (All)
Aliases:

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

-Style​

Specifies the style of the image. Valid values: "default", "person" Default: "default"

  • "default": Standard image rendering.
  • "person": Circular cropping, typically used for profile pictures or avatars.
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: Default
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-AMImage.​

OUTPUTS​

System.Collections.Hashtable​

Returns a hashtable representing the Image element.​

NOTES​

  • Images should be hosted on publicly accessible servers to ensure they display correctly.
  • Consider the following best practices:
    • Use appropriate image sizes to avoid slow loading times.
    • Always include descriptive alt text for accessibility.
    • Use smaller images for mobile viewing.
    • Be aware that some email clients may block external images by default.
  • The "person" style is ideal for profile pictures or avatars, as it applies circular cropping.

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