Files
2025-05-09 16:49:09 -04:00

3.0 KiB

Get-ProxmoxCloudImage

Gets available cloud images from repositories.

Syntax

Get-ProxmoxCloudImage
   [-Distribution <String>]
   [-Release <String>]
   [-Variant <String>]
   [-Force]
   [<CommonParameters>]

Description

The Get-ProxmoxCloudImage cmdlet gets available cloud images from repositories. You can filter the results by distribution, release, and variant.

Parameters

-Distribution

The distribution to filter by (e.g., "ubuntu", "debian").

Type: String
Parameter Sets: (All)
Aliases:

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

-Release

The release version to filter by (e.g., "22.04", "11").

Type: String
Parameter Sets: (All)
Aliases:

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

-Variant

The image variant to filter by (e.g., "server", "minimal").

Type: String
Parameter Sets: (All)
Aliases:

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

-Force

Force refresh of the cloud image cache.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Outputs

PSProxmox.CloudImages.CloudImage

Notes

  • This cmdlet caches the cloud image metadata to improve performance. Use the -Force parameter to refresh the cache.
  • The cmdlet supports Ubuntu and Debian cloud images.

Examples

Example 1: Get all available cloud images

Get-ProxmoxCloudImage

This example gets all available cloud images from all supported repositories.

Example 2: Get Ubuntu cloud images

Get-ProxmoxCloudImage -Distribution "ubuntu"

This example gets all available Ubuntu cloud images.

Example 3: Get Ubuntu 22.04 cloud images

Get-ProxmoxCloudImage -Distribution "ubuntu" -Release "22.04"

This example gets all available Ubuntu 22.04 cloud images.

Example 4: Get Ubuntu 22.04 server cloud images

Get-ProxmoxCloudImage -Distribution "ubuntu" -Release "22.04" -Variant "server"

This example gets all available Ubuntu 22.04 server cloud images.

Example 5: Force refresh of the cloud image cache

Get-ProxmoxCloudImage -Force

This example forces a refresh of the cloud image cache and gets all available cloud images.