Get-AzGalleryImageVersion
Get or list gallery image versions.
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
[-GalleryImageDefinitionName] <String>
[[-Name] <String>]
[-ExpandReplicationStatus]
-GalleryPublicName <String>
-Location <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzGalleryImageVersion
[-ResourceId] <String>
[-ExpandReplicationStatus]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzGalleryImageVersion
[-ExpandReplicationStatus]
[-Location <String>]
[-Community]
[-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
-Community
List community galleries.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
The credentials, account, tenant, and subscription used for communication with Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExpandReplicationStatus
Show replication status.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryImageDefinitionName
The name of the gallery image definition.
| Type: | String |
| Aliases: | GalleryImageName |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryName
The name of the gallery.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryPublicName
The public name of the Shared Image Gallery.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryUniqueName
The unique name of the Shared Image Gallery.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Location
Location of the Shared Image Gallery.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-ResourceGroupName
The name of the resource group.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceId
The resource ID for the gallery image version
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Scope
Specifies galleries shared to subscription or tenant.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Inputs
Outputs
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
Azure PowerShell
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for