Share via

Set-AzureRmVMOperatingSystem

  • Referentie
Module:
AzureRM.Compute

Hiermee stelt u eigenschappen van het besturingssysteem voor een virtuele machine in.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntax

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>]

Description

Met de cmdlet Set-AzureRmVMOperatingSystem worden besturingssysteemeigenschappen voor een virtuele machine ingesteld. U kunt aanmeldingsreferenties, computernaam en besturingssysteemtype opgeven.

Voorbeelden

Voorbeeld 1: Besturingssysteemeigenschappen instellen voor een nieuwe virtuele machine

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

Met de eerste opdracht wordt een wachtwoord geconverteerd naar een beveiligde tekenreeks en vervolgens opgeslagen in de $SecurePassword variabele. Typ voor meer informatie Get-Help ConvertTo-SecureString. Met de tweede opdracht maakt u een referentie voor de gebruiker FullerP en het wachtwoord dat is opgeslagen in $SecurePassword en slaat u vervolgens de referentie op in de $Credential variabele. Typ voor meer informatie Get-Help New-Object. Met de derde opdracht wordt de beschikbaarheidsset met de naam AvailablitySet03 opgehaald in de resourcegroep ResourceGroup11 en wordt dat object vervolgens opgeslagen in de variabele $AvailabilitySet. Met de vierde opdracht wordt een virtuele-machineobject gemaakt en vervolgens opgeslagen in de $VirtualMachine variabele. Met de opdracht wordt een naam en grootte toegewezen aan de virtuele machine. De virtuele machine behoort tot de beschikbaarheidsset die is opgeslagen in $AvailabilitySet. Met de volgende vier opdrachten worden waarden toegewezen aan variabelen die moeten worden gebruikt in de volgende opdracht. Omdat u deze tekenreeksen rechtstreeks in de opdracht Set-AzureRmVMOperatingSystem kunt opgeven, wordt deze methode alleen gebruikt voor leesbaarheid. U kunt echter een benadering zoals deze gebruiken in scripts. Met de laatste opdracht worden besturingssysteemeigenschappen ingesteld voor de virtuele machine die is opgeslagen in $VirtualMachine. De opdracht gebruikt de referenties die zijn opgeslagen in $Credential. De opdracht maakt gebruik van variabelen die zijn toegewezen in eerdere opdrachten voor sommige parameters.

Parameters

-ComputerName

Hiermee geeft u de naam van de computer.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Hiermee geeft u de gebruikersnaam en het wachtwoord voor de virtuele machine op als een PSCredential-object . Gebruik de cmdlet Get-Credential om een referentie te verkrijgen. Typ voor meer informatie Get-Help Get-Credential.

Type:PSCredential
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CustomData

Hiermee geeft u een met base 64 gecodeerde tekenreeks van aangepaste gegevens op. Dit wordt gedecodeerd naar een binaire matrix die wordt opgeslagen als een bestand op de virtuele machine. De maximale lengte van de binaire matrix is 65535 bytes.

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisablePasswordAuthentication

Geeft aan dat met deze cmdlet wachtwoordverificatie wordt uitgeschakeld.

Type:SwitchParameter
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisableVMAgent

Vm-agent inrichten uitschakelen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableAutoUpdate

Geeft aan dat met deze cmdlet automatisch bijwerken wordt ingeschakeld.

Type:SwitchParameter
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Linux

Geeft aan dat het type besturingssysteem Linux is.

Type:SwitchParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ProvisionVMAgent

Geeft aan dat voor de instellingen moet worden vereist dat de virtuele-machineagent op de virtuele machine wordt geïnstalleerd.

Type:SwitchParameter
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TimeZone

Hiermee geeft u de tijdzone voor de virtuele machine.

Type:String
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VM

Hiermee geeft u het lokale virtuele-machineobject op waarop de eigenschappen van het besturingssysteem moeten worden ingesteld. Gebruik de cmdlet Get-AzureRmVM om een object voor een virtuele machine te verkrijgen. Maak een virtuele-machineobject met behulp van de cmdlet New-AzureRmVMConfig.

Type:PSVirtualMachine
Aliases:VMProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Windows

Geeft aan dat het type besturingssysteem Windows is.

Type:SwitchParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WinRMCertificateUrl

Hiermee geeft u de URI van een WinRM-certificaat. Dit moet worden opgeslagen in een sleutelkluis.

Type:Uri
Position:10
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WinRMHttp

Geeft aan dat dit besturingssysteem GEBRUIKMAAKT van HTTP WinRM.

Type:SwitchParameter
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WinRMHttps

Geeft aan dat dit besturingssysteem HTTPS WinRM gebruikt.

Type:SwitchParameter
Position:9
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

PSVirtualMachine

SwitchParameter

String

PSCredential

Uri

Uitvoerwaarden

PSVirtualMachine