Set-AzureRmVMOperatingSystem
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.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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
.
Type: | PSCredential |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisablePasswordAuthentication
Indica che questo cmdlet disabilita l'autenticazione della password.
Type: | SwitchParameter |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisableVMAgent
Disabilitare provisioning dell'agente di macchine virtuali.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAutoUpdate
Indica che questo cmdlet abilita l'aggiornamento automatico.
Type: | SwitchParameter |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Linux
Indica che il tipo di sistema operativo è Linux.
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProvisionVMAgent
Indica che le impostazioni richiedono l'installazione dell'agente di macchine virtuali nella macchina virtuale.
Type: | SwitchParameter |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeZone
Specifica il fuso orario per la macchina virtuale.
Type: | String |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | PSVirtualMachine |
Aliases: | VMProfile |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Windows
Indica che il tipo di sistema operativo è Windows.
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WinRMCertificateUrl
Specifica l'URI di un certificato WinRM. Questa operazione deve essere archiviata in un insieme di credenziali delle chiavi.
Type: | Uri |
Position: | 10 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WinRMHttp
Indica che questo sistema operativo usa HTTP WinRM.
Type: | SwitchParameter |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WinRMHttps
Indica che questo sistema operativo usa WINRM HTTPS.
Type: | SwitchParameter |
Position: | 9 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |