Skip to content

README.md

Latest commit

 

History

History
65 lines (48 loc) · 2.9 KB

README.md

File metadata and controls

65 lines (48 loc) · 2.9 KB

Copy Azure Shared Image Gallery Image Version Across Tenants

PSScriptAnalyzer

This script copies an existing image version from an Azure Shared Image Gallery in one tenant/subscription to another gallery in a different tenant/subscription. It uses a temporary managed disk and AzCopy to move the underlying VHD and then creates a new image version in the target gallery.

🚀 Features

  • Uses SAS URLs and AzCopy for efficient disk transfer.
  • Supports cross-tenant and cross-subscription scenarios.
  • Creates a new image version in an existing target image definition.
  • Updates disk properties (e.g., accelerated networking) to match image requirements.

📦 Prerequisites

  • PowerShell with the Az modules installed.
  • AzCopy installed and available in your PATH.
  • Permissions in both source and target subscriptions to:
    • Read Shared Image Gallery image versions.
    • Create and manage managed disks.
    • Create image versions in the target gallery.
  • Network access to Azure Storage endpoints used by managed disks.

⚙️ Parameters

The script is parameterized. Key parameters:

  • SourceSubscriptionId, SourceResourceGroup, SourceGalleryName, SourceImageDefinitionName, SourceImageVersionName, SourceLocation
  • TargetSubscriptionId, TargetResourceGroup, TargetGalleryName, TargetImageDefinitionName, TargetImageVersionName, TargetLocation
  • Optional: LocalVhdPath, SourceTempDiskName, TargetTempDiskName, SasDurationInSeconds

🧭 Usage

.\Copy-AzGalleryImageVersionAcrossTenants.ps1 `
    -SourceSubscriptionId "00000000-0000-0000-0000-000000000000" `
    -SourceResourceGroup "rg-source-gallery" `
    -SourceGalleryName "sig-source" `
    -SourceImageDefinitionName "win2022-base" `
    -SourceImageVersionName "1.0.0" `
    -SourceLocation "westeurope" `
    -TargetSubscriptionId "11111111-1111-1111-1111-111111111111" `
    -TargetResourceGroup "rg-target-gallery" `
    -TargetGalleryName "sig-target" `
    -TargetImageDefinitionName "win2022-base" `
    -TargetImageVersionName "1.0.1" `
    -TargetLocation "westeurope"

📝 Notes

  • The script downloads the VHD to a local path (default: C:\temp\tempexportdisk.vhd). Ensure you have enough disk space.
  • If the transfer takes longer than the SAS duration, you may need to re-run with a higher SasDurationInSeconds.
  • Clean up temporary disks and local VHDs if you no longer need them.
  • Do not commit any secrets or tenant-specific IDs you consider sensitive into the repository.

📄 Project Governance

✍️ Author

Created and maintained by Handover2AI-byExistence.
If you find this useful, feel free to star ⭐ the repo or open issues for improvements.