Dela via

Set-AzureRmVMOperatingSystem

  • Referens
Modul:
AzureRM.Compute

Anger egenskaperna för operativsystemet för en virtuell dator.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Cmdleten Set-AzureRmVMOperatingSystem anger operativsystemegenskaper för en virtuell dator. Du kan ange inloggningsuppgifter, datornamn och operativsystemtyp.

Exempel

Exempel 1: Ange operativsystemegenskaper för nya virtuella datorer

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

Det första kommandot konverterar ett lösenord till en säker sträng och lagrar det sedan i variabeln $SecurePassword. Om du vill ha mer information skriver du Get-Help ConvertTo-SecureString. Det andra kommandot skapar en autentiseringsuppgift för användaren FullerP och lösenordet som lagras i $SecurePassword och lagrar sedan autentiseringsuppgifterna i variabeln $Credential. Om du vill ha mer information skriver du Get-Help New-Object. Det tredje kommandot hämtar tillgänglighetsuppsättningen med namnet AvailablitySet03 i resursgruppen ResourceGroup11 och lagrar sedan objektet i variabeln $AvailabilitySet. Det fjärde kommandot skapar ett virtuellt datorobjekt och lagrar det sedan i variabeln $VirtualMachine. Kommandot tilldelar ett namn och en storlek till den virtuella datorn. Den virtuella datorn tillhör tillgänglighetsuppsättningen som lagras i $AvailabilitySet. De följande fyra kommandona tilldelar värden till variabler som ska användas i följande kommando. Eftersom du kan ange dessa strängar direkt i kommandot Set-AzureRmVMOperatingSystem används den här metoden endast för läsbarhet. Du kan dock använda en metod som den här i skript. Det sista kommandot anger operativsystemegenskaper för den virtuella datorn som lagras i $VirtualMachine. Kommandot använder autentiseringsuppgifterna som lagras i $Credential. Kommandot använder variabler som tilldelats i tidigare kommandon för vissa parametrar.

Parametrar

-ComputerName

Anger namnet på datorn.

Typ:String
Position:2
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Anger användarnamnet och lösenordet för den virtuella datorn som ett PSCredential-objekt . Om du vill hämta en autentiseringsuppgift använder du cmdleten Get-Credential. Om du vill ha mer information skriver du Get-Help Get-Credential.

Typ:PSCredential
Position:3
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-CustomData

Anger en base-64-kodad sträng med anpassade data. Detta avkodas till en binär matris som sparas som en fil på den virtuella datorn. Den maximala längden på den binära matrisen är 65535 byte.

Typ:String
Position:4
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-DisablePasswordAuthentication

Anger att den här cmdleten inaktiverar lösenordsautentisering.

Typ:SwitchParameter
Position:5
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-DisableVMAgent

Inaktivera Etablera VM-agent.

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableAutoUpdate

Anger att den här cmdleten aktiverar automatisk uppdatering.

Typ:SwitchParameter
Position:6
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Linux

Anger att typen av operativsystem är Linux.

Typ:SwitchParameter
Position:1
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-ProvisionVMAgent

Anger att inställningarna kräver att agenten för den virtuella datorn installeras på den virtuella datorn.

Typ:SwitchParameter
Position:5
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-TimeZone

Anger tidszonen för den virtuella datorn.

Typ:String
Position:7
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-VM

Anger det lokala virtuella datorobjekt som operativsystemegenskaperna ska anges på. Om du vill hämta ett virtuellt datorobjekt använder du cmdleten Get-AzureRmVM. Skapa ett virtuellt datorobjekt med hjälp av cmdleten New-AzureRmVMConfig.

Typ:PSVirtualMachine
Aliases:VMProfile
Position:0
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-Windows

Anger att typen av operativsystem är Windows.

Typ:SwitchParameter
Position:1
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-WinRMCertificateUrl

Anger URI för ett WinRM-certifikat. Detta måste lagras i ett Key Vault.

Typ:Uri
Position:10
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-WinRMHttp

Anger att det här operativsystemet använder HTTP WinRM.

Typ:SwitchParameter
Position:8
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-WinRMHttps

Anger att det här operativsystemet använder HTTPS WinRM.

Typ:SwitchParameter
Position:9
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

Indata

PSVirtualMachine

SwitchParameter

String

PSCredential

Uri

Utdata

PSVirtualMachine