git.lirion.de

Of git, get, and gud

aboutsummaryrefslogtreecommitdiffstats
path: root/AzureHelpers/Public/New-AzVmOsSnapshot.ps1
diff options
context:
space:
mode:
authormail_redacted_for_web 2025-07-24 15:00:20 +0200
committermail_redacted_for_web 2025-07-24 15:00:20 +0200
commit03fbf75c8e8eca13368b9e1545f2721a35af9e68 (patch)
tree010a3b34e0490bd5afab5fb11bdee60693575034 /AzureHelpers/Public/New-AzVmOsSnapshot.ps1
parent1b082205f1e98a084695b042adec5cc122ff7717 (diff)
downloadazure-helpers-03fbf75c8e8eca13368b9e1545f2721a35af9e68.tar.bz2
source was Windows Explorer only :( forgot a few scripts
Diffstat (limited to 'AzureHelpers/Public/New-AzVmOsSnapshot.ps1')
-rw-r--r--AzureHelpers/Public/New-AzVmOsSnapshot.ps151
1 files changed, 51 insertions, 0 deletions
diff --git a/AzureHelpers/Public/New-AzVmOsSnapshot.ps1 b/AzureHelpers/Public/New-AzVmOsSnapshot.ps1
new file mode 100644
index 0000000..dcf6535
--- /dev/null
+++ b/AzureHelpers/Public/New-AzVmOsSnapshot.ps1
@@ -0,0 +1,51 @@
+function New-AzVmOsSnapshot {
+ <#
+ .SYNOPSIS
+ Create a snapshot of the OS disk of an Azure VM.
+
+ .DESCRIPTION
+ If we can unambiguously determine a single VM name inside the subscription
+ we are logged into through the input string, we will create a snapshot
+ of its OS disk.
+
+ .INPUTS
+ System.Object. @{ VmName = VMNAME; SnapshotName = SNAPSHOTNAME }
+
+ .OUTPUTS
+ String. Status messages and the actual AzureCLI outputs.
+ #>
+ [Alias(
+ 'Create-AzVmOsSnapshot',
+ 'azvmsnapshot',
+ 'azvmsnap'
+ )]
+ Param(
+ [Parameter(
+ Mandatory=$true,
+ ValueFromPipelineByPropertyName=$true,
+ HelpMessage="String that is a VM name or is part of one unambiguous VM",
+ Position=0
+ )
+ ]
+ [ValidateLength(1,64)]
+ [string]
+ $VmName,
+ [Parameter(
+ Mandatory=$true,
+ ValueFromPipelineByPropertyName=$true,
+ HelpMessage="Name of the snapshot",
+ Position=1
+ )
+ ]
+ [ValidateLength(1,64)]
+ [string]
+ $SnapshotName
+ )
+ $ErrorActionPreference = 'Stop'
+ $myvm = Find-AzVm -VmName $VmName
+ $myDisk = (az vm show -g $myvm.resourceGroup -n $myvm.name --query "storageProfile.osDisk.managedDisk.id" -o json | ConvertFrom-Json)
+ Write-Host "Identified VM: ${myvm.name}"
+ Write-Host "Creating OS disk snapshot `"${SnapshotName}`""
+ az snapshot create -o jsonc -g $myvm.resourceGroup --source $myDisk --name $SnapshotName `
+ --query '[].{creationData: creationData, diskSizeGB: diskSizeGB, encryptionType: encryption.type, hyperVGeneration: hyperVGeneration, id: id, name: name, resourceGroup: resourceGroup, publicNetworkAccess: publicNetworkAccess}'
+} \ No newline at end of file