--- updatedAt: 2026-05-11T22:29:47.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/powershell/llms.txt --- # Image Get-IVMImage ## Synopsis Get an image. ## Syntax ```powershell Get all (Default) Get-IVMImage -PolicySetID [-Network ] [-PolicyID ] [-Limit ] [-URL ] [-ContractID ] [-EdgeRCFile ] [-Section ] [-AccountSwitchKey ] [-ProgressAction ] [] ``` ```powershell Get one Get-IVMImage -PolicySetID [-Network ] [-ImageID ] [-ContractID ] [-EdgeRCFile ] [-Section ] [-AccountSwitchKey ] [-ProgressAction ] [] ``` ## Description Gets a specific image by its ID. > **Note:** if your account has multiple IVM-enabled contracts you need to specify the contract ID. ## Parameters
‑AccountSwitchKey
String Pipeline input: False

An account credential key that lets you move between accounts when using an API client enabled for multiple accounts. To find account switch keys, use Get-AccountSwitchKey.
‑ContractID
String Pipeline input: False

Your contract's ID.
‑EdgeRCFile
String Pipeline input: False

Your EdgeGrid resource file to authenticate your command. Defaults to ~/.edgerc.
‑ImageID
String Parameter sets: Get one Pipeline input: False

The ID of the image. This ID usually represents the part of the URL after the scheme, host, and port.
‑Limit
Int32 Parameter sets: Get all Pipeline input: False

The maximum number of logs per day.
‑Network
Required
String Accepted values: Staging, Production Pipeline input: False

A type of network to execute the API request on, either Staging or Production.
‑PolicyID
String Parameter sets: Get all Pipeline input: False

Your image or video policy's ID. To get a policy's ID, run Get-IVMPolicy. Use in conjunction with the -Url, -TransformationType, and -Size parameters.
‑PolicySetID
Required
String Pipeline input: False

Your policy set's ID.
‑Section
String Pipeline input: False

The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to default.
‑URL
String Parameter sets: Get all Pipeline input: False

Limits search results to a specific image or video URL.
## Related Links * [User Guide: Image & Video Manager](https://techdocs.akamai.com/powershell/docs/add-and-maintain-policy-rules) * [API Reference](https://techdocs.akamai.com/ivm/reference/get-image) # Sibling pages * [Error details](https://techdocs.akamai.com/powershell/docs/get-ivmerrordetails.md) * [Log details](https://techdocs.akamai.com/powershell/docs/get-ivmlogdetails.md) * [Policy](https://techdocs.akamai.com/powershell/docs/get-ivmpolicy.md) * [Policy history](https://techdocs.akamai.com/powershell/docs/get-ivmpolicyhistory.md) * [Policy set](https://techdocs.akamai.com/powershell/docs/get-ivmpolicyset.md)