Cómo apagar una VM de Azure con un Script

 Apagar una Vm o encenderla utilizando un script no parece complejo, sin embargo, para conectarse a Azure en forma segura hay que cumplir ciertos requisitos.

En este post voy a mostrar cómo conectarse a Azure en forma segura, y sin crededenciales, para una operación sencilla como apagar una VM.

Tener presente que se utilizará autenticación basada en certificados, y los certificados expiran, por lo tanto, hay que anotar en alguna parte la fecha para renovarlo, sino nuestros script fallarán.

Este método es preferido porque evitas tener que almacenar credenciales, en especial si el tenant tiene multi factor auth (MFA) o políticas de seguridad adicionales.

Este documento está basado en los módulos de Az para Powershell

I. Instalar el módulo Az.compute

Este módulo es la nueva forma de conectarse a azure, y reemplaza a AzureRM. Los comandos de AzureRM ya no se podrán utilizar despuésd de febrero de  2024.

Ejecuta en powershell 

install-module Az.compute

Si por alguna razón recibes errores relacionados a NuGet, te recomiendo validar si ese Powershell está actualizado y se puede conectar mediante TLS 1.2 o superior. Ahora Microsoft no admite conexiones anteriores a esa versión. Para estar seguro, ejecuta primero en esa ventana de Powershell:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Una vez realizado, vuelve a ejecutar el comando de instalación, y no deberías recibir errores.

II. Instalar módulo az.resources

Este módulo es necesario para crear la aplicación en Azure

install-module az.resources

III. Importar los módulos

ejecuta los comandos 

import-module az.compute

import-module az.resources

IV. Creación del certificado autofirmado

Para crear el certificado, primero tendrás que conectarte mediante el método tradicional de credenciales.

Connect-AzAccount

Aparecerá una ventana para introducir credenciales. Una vez autorizado, te habrás conecatado a tu Tenant de Azure.

Modifica el código pde acuerdo a tu necesidad. En este caso el Subject es "ScriptAzure2021" y estará almacenado en el contenedor del usuario actual de la Máquina desde la cual vas a ejecutar los scripts remotos.

$cert = New-SelfSignedCertificate -CertStoreLocation "cert:\CurrentUser\My" `

  -Subject "CN=ScriptAzure2021" `

  -KeySpec KeyExchange

$keyValue = [System.Convert]::ToBase64String($cert.GetRawCertData())

#########

V. Creación del App en Azure

#El siguiente comando es para crear el ServicePrincipal.

#Modifica el DisplayName de acuerdo a tus necesidades

$sp = New-AzADServicePrincipal -DisplayName appAzure001 `

  -CertValue $keyValue `

  -EndDate $cert.NotAfter `

  -StartDate $cert.NotBefore


##Espera un minuto antes de continuar. Puedes ingresar al portal Azure, y ver si se creó la App.

## Revisa en "Enterprise Applications - All applications"

VI. Asignación de permisos

Si necesitas realizar cambios en las VM, como apagar o encender, recomiendo el rol Contributor, pero puedes elegir otro. Este es el nivel de permisos que tendrá tu conexión de Scripts.

New-AzRoleAssignment -RoleDefinitionName Contributor -ServicePrincipalName $sp.ApplicationId


VII. Probar conexión

Para probar la conexión, y crear tu script básico. Debes llenar los datos adecuadamente.

$Thumbprint = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'

#corresponde al thumbprint de tu certificado autofirmado

$TenantId = 'yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyy'

#Tu tenant ID de Azure. Lo puedes consultar ingresando a AzureAD

$ApplicationId = '00000000-0000-0000-0000-00000000'

#El application ID de tu aplicación, se puede consultar en "Enterprise Applications - All applications" y filtrando por el DisplayName. 

Connect-AzAccount -CertificateThumbprint $Thumbprint -ApplicationId $ApplicationId -Tenant $TenantId -ServicePrincipal


Ahora que estás conectado, puedes ejecutar tareas como apagar una máquina.

Stop-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"


Guarda tu script como archvo.ps1

Para invocar tu script, puedes usar un .bat con esta sintaxis de ejemplo:

%SystemRoot%\system32\WindowsPowerShell\v1.0\powershell.exe -command "& 'C:\micarpeta\Script-ejemplo.ps1'"

Finalmente, te reitero que recuerdes que debes renovar el certificado cuando expire.


Fuentes:

Connect-AzAccount (Az.Accounts) | Microsoft Docs

Stop-AzVM (Az.Compute) | Microsoft Docs

Comments

Post a Comment

Popular posts from this blog

Update DNS static servers in your local Network

Image
 lets say you need to update your DNS servers, maybe you installed a new Domain Controller in your network. So probably the last step is update in each computer the primary and secondary DNS server. It's sad, but in GPO, you will not find an effective way of doing this for windows10 Instead, you can use this script. $inet1=Get-DnsClient  | Get-DnsClientServerAddress | where{$_.ServerAddresses -contains "192.168.0.245" -or $_.ServerAddresses -contains "192.168.0.207"} foreach($nic in $inet1){     Set-DnsClientServerAddress -InterfaceIndex $nic.InterfaceIndex -ServerAddresses ("192.168.0.245","192.168.0.114") } You can change the old IPs (192.168.0.245 and 192.168.0.207) for new IPs. then, save the file as ChangeDNS.ps1 file in your network Share. Create a New GPO and configure the Schedule Tasks for the Computer node. Configure the task as Immediate Task. Set the user account as SYSTEM. It will automatically convert into NT Authority\system. S...
Read more

LIst all VMs Disk in Hyper-V (VMM)

 Here an easy way to list all your VMs disk.  This will be useful if need to check what disk has every machine.  you can then copy the output to excel  $vms=Get-vm -All $file="listvms.txt" for($i=0;$i -lt $vms.count;$i++){foreach($disk in $vms[$i].VirtualHardDisks.sharepath){ $s=$vms[$i].name+";"+$disk; Write-Output $s | Out-File $file -append utf8}} notepad $file Be aware that second time, you shuld use a different file, otherwise you will be adding the results to the same file
Read more

Powershell Scritp for Inventory VMS in Hyper-V and VMware

Image
 Today I have to create a list of VMS, but with specific information. Usually you will like some basic info from your virtual machines, including, name, amoutn of CPU, RAM and Disk Usage. Seems simple, but the true is a nightmare. The issue is about the Disk usage. When your VMs has only one disk is easy, but what about a machine with 4 disks? What if these disk are thin provisioning and you need to sum the space? Well... here you will learn how, and using simple lines. Get a List of VMS from Virtual Machine Manager If using VMM you can use this method, this will allow a complete list of all hosts and VMS in your environment. #This get the list of all VMs $vms = Get-VM -All #this generate a report including, name, host, status, cpu, ram and disk usage $Report = $vms | select name, vmhost, status, CPUcount, MemoryAssignedMB, @{Name="DiskAllocated";Expression={[math]::round($_.TotalSize/1024/1024/1024,2)}} #this export the report as CSV. Now you can take this to Excel. $Report ...
Read more