> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/powershell-commands/new-udimage.md). # New-UDImage New-UDImage displays an image in a PowerShell Universal dashboard from a URL or local file path, with configurable height, width, and CSS class. ### Synopsis An image component. ### Syntax ```powershell New-UDImage [-Id ] [-Url ] [-Height ] [-Width ] [-Attributes ] [-ClassName ] [] New-UDImage [-Id ] [-Path ] [-Height ] [-Width ] [-Attributes ] [-ClassName ] [] ``` ### Description An image component. ### Parameters #### -Id The ID of this component. ``` Required? false Position? named Default value ([Guid]::NewGuid()) Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Url The URL to the image. ``` Required? false Position? named Default value https://cdnweb.devolutions.net/web/common/logos/powershell-universal-logo.svg Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Path The path to a local image. ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Height The height in pixels. ``` Required? false Position? named Default value 0 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Width The width in pixels. ``` Required? false Position? named Default value 0 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Attributes Additional attributes to apply to the img tag. ``` Required? false Position? named Default value @{} Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ClassName A CSS class to apply to the image. ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### Common parameters 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). ### Outputs ### Examples #### Example 1: Basic image ```powershell New-UDImage -Url "https://cdnweb.devolutions.net/web/common/logos/powershell-universal-logo.svg" ``` Displays an image. #### Example 2: Local image ```powershell $Image = Get-ChildItem "$PSScriptRoot\*.png" | Select-Object -First 1 New-UDImage -Path ($Image.FullName) ``` Displays a local image. #### Example 3: Image with height and width ```powershell New-UDImage -Url "https://cdnweb.devolutions.net/web/common/logos/powershell-universal-logo.svg" -Height 100 -Width 100 ``` Displays an image with a height and width. #### Example 4: Image with style ```powershell New-UDImage -Url "https://cdnweb.devolutions.net/web/common/logos/powershell-universal-logo.svg" -Attributes @{ style = @{ borderRadius = '50%' } } ``` Displays an image with a style attribute. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/powershell-commands/new-udimage.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.