Condividi tramite

Set-AzureRmVMOperatingSystem

  • Riferimento
Modulo:
AzureRM.Compute

Configura le proprietà del sistema operativo per una macchina virtuale.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Set-AzureRmVMOperatingSystem
   [-VM] <PSVirtualMachine>
   [-Windows]
   [-ComputerName] <String>
   [-Credential] <PSCredential>
   [[-CustomData] <String>]
   [-ProvisionVMAgent]
   [-EnableAutoUpdate]
   [[-TimeZone] <String>]
   [-WinRMHttp]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmVMOperatingSystem
   [-VM] <PSVirtualMachine>
   [-Windows]
   [-ComputerName] <String>
   [-Credential] <PSCredential>
   [[-CustomData] <String>]
   [-ProvisionVMAgent]
   [-EnableAutoUpdate]
   [[-TimeZone] <String>]
   [-WinRMHttp]
   [-WinRMHttps]
   [-WinRMCertificateUrl] <Uri>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmVMOperatingSystem
   [-VM] <PSVirtualMachine>
   [-Windows]
   [-ComputerName] <String>
   [-Credential] <PSCredential>
   [[-CustomData] <String>]
   [-DisableVMAgent]
   [-EnableAutoUpdate]
   [[-TimeZone] <String>]
   [-WinRMHttp]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmVMOperatingSystem
   [-VM] <PSVirtualMachine>
   [-Windows]
   [-ComputerName] <String>
   [-Credential] <PSCredential>
   [[-CustomData] <String>]
   [-DisableVMAgent]
   [-EnableAutoUpdate]
   [[-TimeZone] <String>]
   [-WinRMHttp]
   [-WinRMHttps]
   [-WinRMCertificateUrl] <Uri>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmVMOperatingSystem
   [-VM] <PSVirtualMachine>
   [-Linux]
   [-ComputerName] <String>
   [-Credential] <PSCredential>
   [[-CustomData] <String>]
   [-DisablePasswordAuthentication]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzureRmVMOperatingSystem imposta le proprietà del sistema operativo per una macchina virtuale. È possibile specificare le credenziali di accesso, il nome del computer e il tipo di sistema operativo.

Esempio

Esempio 1: Impostare le proprietà del sistema operativo per una nuova macchina virtuale

PS C:\> $SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
PS C:\> $Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword); 
PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03" 
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
PS C:\> $ComputerName = "ContosoVM122"
PS C:\> $WinRMCertUrl = "http://keyVaultName.vault.azure.net/secrets/secretName/secretVersion"
PS C:\> $TimeZone = "Pacific Standard Time"
PS C:\> $CustomData = "echo 'Hello World'"
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $$VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -WinRMHttp -WinRMHttps -WinRMCertificateUrl $WinRMCertUrl -ProvisionVMAgent -EnableAutoUpdate -TimeZone $TimeZone

Il primo comando converte una password in una stringa protetta e quindi la archivia nella variabile $SecurePassword. Per ulteriori informazioni, digitare Get-Help ConvertTo-SecureString. Il secondo comando crea una credenziale per l'utente FullerP e la password archiviata in $SecurePassword, quindi archivia le credenziali nella variabile $Credential. Per ulteriori informazioni, digitare Get-Help New-Object. Il terzo comando ottiene il set di disponibilità denominato AvailablitySet03 nel gruppo di risorse denominato ResourceGroup11 e quindi archivia tale oggetto nella variabile $AvailabilitySet. Il quarto comando crea un oggetto macchina virtuale e quindi lo archivia nella variabile $VirtualMachine. Il comando assegna un nome e una dimensione alla macchina virtuale. La macchina virtuale appartiene al set di disponibilità archiviato in $AvailabilitySet. I quattro comandi successivi assegnano valori alle variabili da usare nel comando seguente. Poiché è possibile specificare queste stringhe direttamente nel comando Set-AzureRmVMOperatingSystem , questo approccio viene usato solo per la leggibilità. Tuttavia, è possibile usare un approccio come questo negli script. Il comando finale imposta le proprietà del sistema operativo per la macchina virtuale archiviata in $VirtualMachine. Il comando usa le credenziali archiviate in $Credential. Il comando usa le variabili assegnate nei comandi precedenti per alcuni parametri.

Parametri

-ComputerName

Specifica il nome del computer.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Credential

Specifica il nome utente e la password per la macchina virtuale come oggetto PSCredential . Per ottenere credenziali, usare il cmdlet Get-Credential. Per ulteriori informazioni, digitare Get-Help Get-Credential.

Tipo:PSCredential
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-CustomData

Specifica una stringa con codifica base 64 di dati personalizzati. Questa operazione viene decodificata in una matrice binaria salvata come file nella macchina virtuale. La lunghezza massima della matrice binaria è di 65535 byte.

Tipo:String
Posizione:4
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisablePasswordAuthentication

Indica che questo cmdlet disabilita l'autenticazione della password.

Tipo:SwitchParameter
Posizione:5
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DisableVMAgent

Disabilitare provisioning dell'agente di macchine virtuali.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableAutoUpdate

Indica che questo cmdlet abilita l'aggiornamento automatico.

Tipo:SwitchParameter
Posizione:6
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Linux

Indica che il tipo di sistema operativo è Linux.

Tipo:SwitchParameter
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ProvisionVMAgent

Indica che le impostazioni richiedono l'installazione dell'agente di macchine virtuali nella macchina virtuale.

Tipo:SwitchParameter
Posizione:5
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TimeZone

Specifica il fuso orario per la macchina virtuale.

Tipo:String
Posizione:7
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VM

Specifica l'oggetto macchina virtuale locale in cui impostare le proprietà del sistema operativo. Per ottenere un oggetto macchina virtuale, usare il cmdlet Get-AzureRmVM. Creare un oggetto macchina virtuale usando il cmdlet New-AzureRmVMConfig.

Tipo:PSVirtualMachine
Alias:VMProfile
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Windows

Indica che il tipo di sistema operativo è Windows.

Tipo:SwitchParameter
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WinRMCertificateUrl

Specifica l'URI di un certificato WinRM. Questa operazione deve essere archiviata in un insieme di credenziali delle chiavi.

Tipo:Uri
Posizione:10
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WinRMHttp

Indica che questo sistema operativo usa HTTP WinRM.

Tipo:SwitchParameter
Posizione:8
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WinRMHttps

Indica che questo sistema operativo usa WINRM HTTPS.

Tipo:SwitchParameter
Posizione:9
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

PSVirtualMachine

SwitchParameter

String

PSCredential

Uri

Output

PSVirtualMachine