Galerieresources weergeven, bijwerken en verwijderen

Artikel
04/03/2023

U kunt uw Azure Compute Gallery-resources (voorheen bekend als Shared Image Gallery) beheren met behulp van de Azure CLI of Azure PowerShell.

Galerieën weergeven die met u zijn gedeeld

Galerieën weergeven die zijn gedeeld met uw abonnement.

region=westus
az sig list-shared --location $region

Galerieën weergeven die zijn gedeeld met uw tenant.

region=westus
az sig list-shared --location $region --shared-to tenant

De uitvoer bevat de openbare name en uniqueID de galerie die met u wordt gedeeld. U kunt de naam van de galerie gebruiken om te zoeken naar afbeeldingen die beschikbaar zijn via de galerie.

Hier volgt een voorbeeld van uitvoer:

[
  {
    "location": "westus",
    "name": "1231b567-8a99-1a2b-1a23-123456789abc-MYDIRECTSHARED",
    "uniqueId": "/SharedGalleries/1231b567-8a99-1a2b-1a23-123456789abc-MYDIRECTSHARED"
  }
]

Galerieën weergeven die zijn gedeeld met een abonnement.

GET
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Compute/Locations/{location}/SharedGalleries?api-version=2020-09-30

Het antwoord moet er ongeveer als volgt uitzien:

{	 
"value": [ 
{ 
"identifier": { 
"uniqueId": "/SharedGalleries/{SharedGalleryUniqueName}"         
}, 
"name": "galleryuniquename1", 
   		"type": "Microsoft. Compute/sharedGalleries", 
   		"location": "location" 
  	}, 
  	{ 
"identifier": { 
"uniqueName": "/SharedGalleries/{SharedGalleryUniqueName}"       
}, 
"name": "galleryuniquename2", 
"type": "Microsoft. Compute/sharedGalleries", 
"location": "location" 
  	} 
], 
}

De galerieën weergeven die worden gedeeld met een tenant.

GET
https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/Locations/{location}/SharedGalleries?api-version=2020-09-30&sharedTo=tenant

Het antwoord moet er ongeveer als volgt uitzien:

{	 
"value": [ 
{ 
"identifier": { 
"uniqueName": "/SharedGalleries/{SharedGalleryUniqueName}"         
}, 
"name": "galleryuniquename1", 
   		"type": "Microsoft. Compute/sharedGalleries", 
   		"location": "location" 
  	}, 
  	{ 
"identifier": { 
"uniqueName": "/SharedGalleries/{SharedGalleryUniqueName}"       
}, 
"name": "galleryuniquename2", 
"type": "Microsoft. Compute/sharedGalleries", 
"location": "location" 
  	} 
], 
} 

---

## List your gallery information

### [CLI](#tab/cli)

Get the location, status and other information about your image galleries using [az sig list](/cli/azure/sig#az-sig-list).

```azurecli-interactive 
az sig list -o table

De definities van de installatiekopieën weergeven

Gebruik az sig image-definition list om de definities van de installatiekopieën in uw galerie weer te geven, inclusief informatie over het type en de status van het besturingssysteem.

az sig image-definition list --resource-group myGalleryRG --gallery-name myGallery -o table

Versies van installatiekopieën weergeven

Geef versies van installatiekopieën weer in uw galerie met az sig image-version list:

az sig image-version list --resource-group myGalleryRG --gallery-name myGallery --gallery-image-definition myImageDefinition -o table

Een specifieke versie van de installatiekopieën ophalen

Haal de id van een specifieke installatiekopieënversie op in uw galerie met az sig image-version show.

az sig image-version show \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --query "id"

Alle galerieën op naam weergeven.

$galleries = Get-AzResource -ResourceType Microsoft.Compute/galleries
$galleries.Name

Alle installatiekopieën op naam weergeven.

$imageDefinitions = Get-AzResource -ResourceType Microsoft.Compute/galleries/images
$imageDefinitions.Name

Alle versies van installatiekopieën weergeven op naam.

$imageVersions = Get-AzResource -ResourceType Microsoft.Compute/galleries/images/versions
$imageVersions.Name

Een installatiekopieënversie verwijderen. In dit voorbeeld wordt de installatiekopieënversie met de naam 1.0.0 verwijderd.

Remove-AzGalleryImageVersion `
   -GalleryImageDefinitionName myImageDefinition `
   -GalleryName myGallery `
   -Name 1.0.0 `
   -ResourceGroupName myGalleryRG

Resources bijwerken

Er gelden enkele beperkingen voor wat er kan worden bijgewerkt. De volgende items kunnen worden bijgewerkt:

Azure Compute Gallery:

Beschrijving

Definitie van installatiekopie:

Aanbevolen vCPU's
Aanbevolen geheugen
Beschrijving
Datum einde levensduur

Versie van installatiekopie:

Aantal regionale replica's
Doelregio's
Uitsluiting van meest recente
Datum einde levensduur

CLI
PowerShell

Werk de beschrijving van een galerie bij met behulp van (az sig update.

az sig update \
   --gallery-name myGallery \
   --resource-group myGalleryRG \
   --set description="My updated description."

Werk de beschrijving van een afbeeldingsdefinitie bij met az sig image-definition update.

az sig image-definition update \
   --gallery-name myGallery\
   --resource-group myGalleryRG \
   --gallery-image-definition myImageDefinition \
   --set description="My updated description."

Werk een installatiekopieënversie bij om een regio toe te voegen waarnaar u wilt repliceren met behulp van az sig image-version update. Deze wijziging duurt even als de afbeelding wordt gerepliceerd naar de nieuwe regio.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --add publishingProfile.targetRegions  name=eastus

In dit voorbeeld ziet u hoe u az sig image-version update gebruikt om uit te sluiten dat deze versie van de installatiekopieën wordt gebruikt als de meest recente installatiekopieën.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --set publishingProfile.excludeFromLatest=true

In dit voorbeeld ziet u hoe u az sig image-version update gebruikt om deze installatiekopieënversie op te nemen in overweging genomen voor de meest recente installatiekopieën.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --set publishingProfile.excludeFromLatest=false

Gebruik Update-AzGallery om de beschrijving van een galerie bij te werken.

Update-AzGallery `
   -Name $gallery.Name ` 
   -ResourceGroupName $resourceGroup.Name

In dit voorbeeld ziet u hoe u Update-AzGalleryImageDefinition gebruikt om de einddatum voor de definitie van de installatiekopie bij te werken.

Update-AzGalleryImageDefinition `
   -GalleryName $gallery.Name `
   -Name $galleryImage.Name `
   -ResourceGroupName $resourceGroup.Name `
   -EndOfLifeDate 01/01/2030

In dit voorbeeld ziet u hoe u Update-AzGalleryImageVersion gebruikt om uit te sluiten dat deze versie van de installatiekopie wordt gebruikt als de meest recente installatiekopie.

Update-AzGalleryImageVersion `
   -GalleryImageDefinitionName $galleryImage.Name `
   -GalleryName $gallery.Name `
   -Name $galleryVersion.Name `
   -ResourceGroupName $resourceGroup.Name `
   -PublishingProfileExcludeFromLatest

In dit voorbeeld ziet u hoe u Update-AzGalleryImageVersion gebruikt om deze installatiekopieversie op te nemen in overweging genomen voor de meest recente installatiekopie.

Update-AzGalleryImageVersion `
   -GalleryImageDefinitionName $galleryImage.Name `
   -GalleryName $gallery.Name `
   -Name $galleryVersion.Name `
   -ResourceGroupName $resourceGroup.Name `
   -PublishingProfileExcludeFromLatest:$false

Resources verwijderen

U moet resources in omgekeerde volgorde verwijderen door eerst de versie van de installatiekopieën te verwijderen. Nadat u alle versies van de installatiekopieën hebt verwijderd, kunt u de definitie van de installatiekopieën verwijderen. Nadat u alle installatiekopieën hebt verwijderd, kunt u de galerie verwijderen.

CLI
PowerShell

Voordat u een gedeelde communitygalerie kunt verwijderen, moet u az sig share reset gebruiken om te stoppen met het openbaar delen van de galerie.

Verwijder een installatiekopieënversie met az sig image-version delete.

az sig image-version delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0

Verwijder een afbeeldingsdefinitie met az sig image-definition delete.

az sig image-definition delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition

Een galerie verwijderen met az sig delete.

az sig delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery

$resourceGroup = "myResourceGroup"
$gallery = "myGallery"
$imageDefinition = "myImageDefinition"
$imageVersion = "myImageVersion"

Remove-AzGalleryImageVersion `
   -GalleryImageDefinitionName $imageDefinition `
   -GalleryName $gallery `
   -Name $imageVersion `
   -ResourceGroupName $resourceGroup

Remove-AzGalleryImageDefinition `
   -ResourceGroupName $resourceGroup `
   -GalleryName $gallery `
   -GalleryImageDefinitionName $imageDefinition

Remove-AzGallery `
   -Name $gallery `
   -ResourceGroupName $resourceGroup

Remove-AzResourceGroup -Name $resourceGroup

Communitygalerieën

Belangrijk

Azure Compute Gallery: communitygalerieën zijn momenteel in PREVIEW en zijn onderhevig aan de Preview-voorwaarden voor Azure Compute Gallery - communitygalerie.

Als u een communitygalerie wilt publiceren, moet u preview-functies instellen in uw Azure-abonnement. Het maken van VM's vanuit communitygalerieinstallatiekopieën staat open voor alle Azure-gebruikers.

Uw eigen galerieën weergeven en de openbare namen voor uw communitygalerieën uitvoeren:

az sig list --query [*]."{Name:name,PublicName:sharingProfile.communityGalleryInfo.publicNames}"

Notitie

Als eindgebruiker moet u momenteel de portal gebruiken om de openbare naam van een communitygalerie op te halen. Ga naar Virtuele machines> VirtueleAzure-machine>maken>Installatiekopieën>Bekijk alle installatiekopieën>Naam van community-installatiekopieën>Openbare galerie.

Maak een lijst met alle installatiekopieën die beschikbaar zijn in een communitygalerie met behulp van az sig image-definition list-community.

In dit voorbeeld vermelden we alle installatiekopieën in de galerie ContosoImage in VS - west en op naam, de unieke id die nodig is om een VM, het besturingssysteem en de status van het besturingssysteem te maken.

 az sig image-definition list-community \
   --public-gallery-name "ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f" \
   --location westus \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

Geef versies van installatiekopieën weer die zijn gedeeld in een communitygalerie met behulp van az sig image-version list-community:

az sig image-version list-community \
   --location westus \
   --public-gallery-name "ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f" \
   --gallery-image-definition myImageDefinition \
   --query [*]."{Name:name,UniqueId:uniqueId}" \
   -o table

Directe gedeelde galerieën

Belangrijk

Azure Compute Gallery: direct gedeelde galerie is momenteel in PREVIEW en is onderhevig aan de Preview-voorwaarden voor Azure Compute Gallery.

Als u afbeeldingen wilt publiceren naar een direct gedeelde galerie tijdens de preview, moet u zich registreren op https://aka.ms/directsharedgallery-preview. Het maken van VM's vanuit een direct gedeelde galerie is toegankelijk voor alle Azure-gebruikers.

Tijdens de preview moet u een nieuwe galerie maken, waarbij de eigenschap sharingProfile.permissions is ingesteld op Groups. Wanneer u de CLI gebruikt om een galerie te maken, gebruikt u de --permissions groups parameter . U kunt geen bestaande galerie gebruiken. De eigenschap kan momenteel niet worden bijgewerkt.

Als u wilt uniqueID zoeken naar een galerie die met u is gedeeld, gebruikt u az sig list-shared. In dit voorbeeld zoeken we galerieën in de regio VS - west.

region=westus
az sig list-shared --location $region --query "[].uniqueId" -o tsv

Maak een lijst met alle installatiekopieën die rechtstreeks met u worden gedeeld, gebruik az sig image-definition list-shared.

In dit voorbeeld vermelden we alle installatiekopieën in de galerie in VS - west en op naam, de unieke id die nodig is om een VM, het besturingssysteem en de status van het besturingssysteem te maken.

name="1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f-myDirectShared"
 az sig image-definition list-shared \
   --gallery-unique-name $name
   --location $region \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

Geef versies van installatiekopieën weer die rechtstreeks met u worden gedeeld met behulp van az sig image-version list-shared:

imgDef="myImageDefinition"
az sig image-version list-shared \
   --location $region \
   --public-gallery-name $name \
   --gallery-image-definition $imgDef \
   --query [*]."{Name:name,UniqueId:uniqueId}" \
   -o table

Volgende stappen

Maak een definitie van een installatiekopieën en een versie van de installatiekopieën.
Een virtuele machine maken op basis van een gegeneraliseerde of gespecialiseerde installatiekopieën in een Azure Compute Gallery.

Delen via