Get-AzGalleryImageVersion
Get or list gallery image versions.
Note
This is the previous version of our documentation. Please consult the most recent version for up-to-date information.
Syntax
Get-AzGalleryImageVersion
[-ResourceGroupName] <String>
[-GalleryName] <String>
[-GalleryImageDefinitionName] <String>
[[-Name] <String>]
[-ExpandReplicationStatus]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzGalleryImageVersion
[-GalleryImageDefinitionName] <String>
[[-Name] <String>]
[-ExpandReplicationStatus]
-GalleryUniqueName <String>
[-Scope <String>]
-Location <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzGalleryImageVersion
[-ResourceId] <String>
[-ExpandReplicationStatus]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Get or list gallery image versions.
Examples
Example 1
Get-AzGalleryImageVersion -ResourceGroupName rg1 -GalleryName gallery1 -GalleryImageDefinitionName image1 -GalleryImageVersionName 1.0.0
ResourceGroupName : rg1
PublishingProfile :
TargetRegions[0] :
Name : South Central US
RegionalReplicaCount : 1
TargetRegions[1] :
Name : East US 2
RegionalReplicaCount : 2
TargetRegions[2] :
Name : Central US
RegionalReplicaCount : 1
Source :
ManagedImage :
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/
providers/Microsoft.Compute/images/test1
ReplicaCount : 1
ExcludeFromLatest : False
PublishedDate : 11/14/2018 12:00:00 AM
EndOfLifeDate : 2/18/2025 12:07:00 PM
ProvisioningState : Succeeded
StorageProfile :
OsDiskImage :
SizeInGB : 127
HostCaching : ReadWrite
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/
providers/Microsoft.Compute/galleries/gallery1/images/image1/versions/1.0.0
Name : 1.0.0
Type : Microsoft.Compute/galleries/images/versions
Location : eastus2
Tags : {}Get the gallery image version.
Example 2
Get-AzGalleryImageVersion -ResourceGroupName rg1 -GalleryName gallery1 -GalleryImageDefinitionName image1 -GalleryImageVersionName 1*
ResourceGroupName : rg1
PublishingProfile :
TargetRegions[0] :
Name : South Central US
RegionalReplicaCount : 1
TargetRegions[1] :
Name : East US 2
RegionalReplicaCount : 2
TargetRegions[2] :
Name : Central US
RegionalReplicaCount : 1
Source :
ManagedImage :
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/
providers/Microsoft.Compute/images/test1
ReplicaCount : 1
ExcludeFromLatest : False
PublishedDate : 11/14/2018 12:00:00 AM
EndOfLifeDate : 2/18/2025 12:07:00 PM
ProvisioningState : Succeeded
StorageProfile :
OsDiskImage :
SizeInGB : 127
HostCaching : ReadWrite
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/
providers/Microsoft.Compute/galleries/gallery1/images/image1/versions/1.0.0
Name : 1.0.0
Type : Microsoft.Compute/galleries/images/versions
Location : eastus2
Tags : {}
ResourceGroupName : rg1
PublishingProfile :
TargetRegions[0] :
Name : South Central US
RegionalReplicaCount : 1
TargetRegions[1] :
Name : East US 2
RegionalReplicaCount : 2
TargetRegions[2] :
Name : Central US
RegionalReplicaCount : 1
Source :
ManagedImage :
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/
providers/Microsoft.Compute/images/test1
ReplicaCount : 1
ExcludeFromLatest : False
PublishedDate : 11/14/2018 12:00:00 AM
EndOfLifeDate : 2/18/2025 12:07:00 PM
ProvisioningState : Succeeded
StorageProfile :
OsDiskImage :
SizeInGB : 127
HostCaching : ReadWrite
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/
providers/Microsoft.Compute/galleries/gallery1/images/image1/versions/1.1.0
Name : 1.1.0
Type : Microsoft.Compute/galleries/images/versions
Location : eastus2
Tags : {}Get the gallery image versions that starts with "1".
Example 3
Get-AzGalleryImageVersion -ResourceGroupName rg1 -GalleryName gallery1 -GalleryImageDefinitionName image1
ResourceGroupName : rg1
PublishingProfile :
TargetRegions[0] :
Name : South Central US
RegionalReplicaCount : 1
TargetRegions[1] :
Name : East US 2
RegionalReplicaCount : 2
TargetRegions[2] :
Name : Central US
RegionalReplicaCount : 1
Source :
ManagedImage :
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/
providers/Microsoft.Compute/images/test1
ReplicaCount : 1
ExcludeFromLatest : False
PublishedDate : 11/14/2018 12:00:00 AM
EndOfLifeDate : 2/18/2025 12:07:00 PM
ProvisioningState : Succeeded
StorageProfile :
OsDiskImage :
SizeInGB : 127
HostCaching : ReadWrite
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/
providers/Microsoft.Compute/galleries/gallery1/images/image1/versions/1.0.0
Name : 1.0.0
Type : Microsoft.Compute/galleries/images/versions
Location : eastus2
Tags : {}
ResourceGroupName : rg1
PublishingProfile :
TargetRegions[0] :
Name : South Central US
RegionalReplicaCount : 1
TargetRegions[1] :
Name : East US 2
RegionalReplicaCount : 2
TargetRegions[2] :
Name : Central US
RegionalReplicaCount : 1
Source :
ManagedImage :
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/
providers/Microsoft.Compute/images/test1
ReplicaCount : 1
ExcludeFromLatest : False
PublishedDate : 11/14/2018 12:00:00 AM
EndOfLifeDate : 2/18/2025 12:07:00 PM
ProvisioningState : Succeeded
StorageProfile :
OsDiskImage :
SizeInGB : 127
HostCaching : ReadWrite
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/
providers/Microsoft.Compute/galleries/gallery1/images/image1/versions/1.1.0
Name : 1.1.0
Type : Microsoft.Compute/galleries/images/versions
Location : eastus2
Tags : {}Get all gallery image versions.
Parameters
-DefaultProfile
The credentials, account, tenant, and subscription used for communication with Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExpandReplicationStatus
Show replication status.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryImageDefinitionName
The name of the gallery image definition.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryName
The name of the gallery.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryUniqueName
The unique name of the Shared Image Gallery.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Location
Location of the Shared Image Gallery.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
The name of the gallery image version.
| Type: | String |
| Aliases: | GalleryImageVersionName |
| Position: | 3 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-ResourceGroupName
The name of the resource group.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceId
The resource ID for the gallery image version
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Scope
Specifies galleries shared to subscription or tenant.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |