سرد موارد المعرض وتحديثها وحذفها

يمكنك إدارة معرض الحساب في Azure (المعروفة سابقًا باسم معرض الصور المشتركة) باستخدام Azure CLI أو Azure PowerShell.

قائمة المعارض التي تمت مشاركتها معك

CLI

قائمة المعارض المشتركة مع اشتراكك.

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

قائمة المعارض المشتركة مع المستأجر الخاص بك.

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

سيحتوي الإخراج على الجمهور name وuniqueIDالمعرض الذي تتم مشاركته معك. يمكنك استخدام اسم المعرض للاستعلام عن الصور المتوفرة من خلال المعرض.

هنا مثال الإخراج:

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

تطبيقات REST

قائمة المعارض المشتركة مع الاشتراك.

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

يجب أن تبدو الاستجابة مماثلة لذلك:

{	 
"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" 
  	} 
], 
} 

قائمة المعارض المشتركة مع المستأجر.

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

يجب أن تبدو الاستجابة مماثلة لذلك:

{	 
"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

سرد تعريفات الصورة

تمتع بسرد تعريفات الصور في معرضك، بما في ذلك معلومات حول نوع نظام التشغيل وحالته، باستخدام az sig سرد تعريف الصورة.

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

سرد إصدارات الصورة

تمتع بسرد إصدارات الصور في معرضك باستخدام az sig سرد إصدار الصورة:

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

الحصول على إصدار صورة محدد

احصل على معرف إصدار صورة محدد في المعرض باستخدام az sig إظهار إصدار الصورة.

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

PowerShell

إدراج جميع المعارض حسب الاسم.

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

إدراج جميع تعريفات الصور حسب الاسم.

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

إدراج جميع إصدارات الصور حسب الاسم.

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

حذف إصدار صورة. يحذف هذا المثال إصدار الصورة المسمى 1.0.0.

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

تحديث الموارد

هناك بعض القيود على ما يمكن تحديثه. يمكن تحديث العناصر التالية:

معرض الحساب في Azure:

• الوصف

تعريف الصورة:

• وحدات المعالجة المركزية الظاهرية الموصى بها
• الذاكرة الموصى بها
• الوصف
• تاريخ انتهاء العمر

إصدار الصورة:

• عدد النسخ المتماثلة الإقليمية
• المناطق المستهدفة
• الاستبعاد من الأحدث
• تاريخ نهاية دورة الحياة

CLI

قم بتحديث وصف معرض باستخدام az sig update.

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

قم بتحديث وصف تعريف صورة باستخدام 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."

قم بتحديث إصدار صورة لإضافة منطقة لتكرارها باستخدام az sig image-version update. سيستغرق هذا التغيير بعض الوقت، حيث يتم نسخ الصورة نسخًا متماثلاً إلى المنطقة الجديدة.

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

يوضح هذا المثال كيفية استخدام az sig image-version update لاستبعاد إصدار الصورة هذا من الاستخدام كـ أحدث صورة.

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

يوضح هذا المثال كيفية استخدام az sig image-version update لتضمين إصدار الصورة هذا في الاعتبار للحصول على أحدث صورة.

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

PowerShell

لتحديث وصف معرض، استخدم Update-AzGallery.

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

يوضح هذا المثال كيفية استخدام Update-AzGalleryImageDefinition لتحديث تاريخ انتهاء العمر الافتراضي لتعريف الصورة.

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

يوضح هذا المثال كيفية استخدام Update-AzGalleryImageVersion لاستبعاد إصدار الصورة هذا من استخدامه كأحدث صورة.

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

يوضح هذا المثال كيفية استخدام Update-AzGalleryImageVersion لتضمين إصدار الصورة هذا في الاعتبار للحصول على أحدث صورة.

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

حذف الموارد

يجب عليك حذف الموارد بترتيب عكسي، عن طريق حذف إصدار الصورة أولاً. بعد حذف كافة إصدارات الصور، يمكنك حذف تعريف الصورة. بعد حذف كافة تعريفات الصور، يمكنك حذف المعرض.

CLI

قبل أن تتمكن من حذف معرض مشترك للمجتمع، تحتاج إلى استخدام az sig إعادة تعيين مشاركة لإيقاف مشاركة المعرض بشكل عام.

حذف إصدار صورة باستخدام 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 

حذف تعريف صورة باستخدام az sig image-definition delete.

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

حذف معرض باستخدام az sig delete.

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

PowerShell

$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

معارض المجتمع

هام

Azure Compute Gallery – معرض المجتمع موجود حاليًا في PREVIEW ويخضع لشروط المعاينة لـ Azure Compute Gallery - معرض المجتمع.

لنشر معرض مجتمع، ستحتاج إلى إعداد ميزات المعاينة في اشتراك Azure الخاص بك. إنشاء أجهزة ظاهرية من صور معرض المجتمع مفتوح لجميع مستخدمي Azure.

لسرد معارضك الخاصة، وإخراج الأسماء العامة لمعارض المجتمع لديك:

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

ملاحظة

بصفتك مستخدمًا نهائيًا، تحتاج لاستخدام المدخل حاليًا للحصول على الاسم العام لمعرض المجتمع. انتقل إلى الأجهزة الظاهرية>إنشاء>جهاز Azure الظاهري>صورة>عرض كل الصور>صور المجتمع>اسم المعرض العام.

تمتع بسرد كل تعريفات الصور المتوفرة في معرض المجتمع باستخدام az sig سرد تعريف الصورة - المجتمع.

في هذا المثال، نقوم بإدراج جميع الصور في معرض ContosoImage في غرب الولايات المتحدة وبالاسم، المعرف الفريد المطلوب لإنشاء جهاز ظاهري VM و OS وحالة OS.

 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

تمتع بسرد إصدارات الصور التي تمت مشاركتها في معرض مجتمع باستخدام az sig سرد إصدار الصورة - المجتمع:

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

---

المعارض المشتركة المباشرة

هام

Azure Compute Gallery - المعرض المشترك المباشر موجود حاليًا في PREVIEW ويخضع لشروط المعاينة لـ Azure Compute Gallery.

لنشر الصور إلى معرض مشترك مباشر أثناء المعاينة، تحتاج إلى التسجيل في https://aka.ms/directsharedgallery-preview. إنشاء الأجهزة الظاهرية من معرض مشترك مباشر مفتوح لجميع مستخدمي Azure.

أثناء المعاينة، تحتاج إلى إنشاء معرض جديد، مع تعيين الخاصية sharingProfile.permissions إلى Groups. عند استخدام CLI لإنشاء معرض، استخدم المعلمة --permissions groups. لا يمكنك استخدام معرض موجود، لا يمكن تحديث الخاصية حاليًا.

للعثور على uniqueID معرض تمت مشاركته معك، استخدم az sig list-shared. في هذا المثال، نبحث عن صالات عرض في منطقة غرب الولايات المتحدة.

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

اسرد جميع تعريفات الصور التي تتم مشاركتها معك مباشرة، واستخدم قائمة az sig image-definition المشتركة.

في هذا المثال، نقوم بإدراج جميع الصور الموجودة في المعرض في غرب الولايات المتحدة وبالاسم، المعرف الفريد المطلوب لإنشاء حالة VM و OS و OS.

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

سرد إصدارات الصور المشتركة مباشرة معك باستخدام 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

الخطوات التالية

• قم بإنشاء تعريف صورة وإصدار صورة.
• إنشاء جهاز ظاهري من صورة معممة أو متخصصة في Azure Compute Gallery.