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.

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

Input

PSVirtualMachine

SwitchParameter

String

PSCredential

Uri

Output