Set-AzureRmVMOperatingSystem
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 |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | 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 |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | 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 |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Typ: | IAzureContextContainer |
Alias: | AzureRmContext, AzureCredential |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-DisablePasswordAuthentication
Anger att den här cmdleten inaktiverar lösenordsautentisering.
Typ: | SwitchParameter |
Position: | 5 |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-DisableVMAgent
Inaktivera Etablera VM-agent.
Typ: | SwitchParameter |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-EnableAutoUpdate
Anger att den här cmdleten aktiverar automatisk uppdatering.
Typ: | SwitchParameter |
Position: | 6 |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-Linux
Anger att typen av operativsystem är Linux.
Typ: | SwitchParameter |
Position: | 1 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | 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 |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-TimeZone
Anger tidszonen för den virtuella datorn.
Typ: | String |
Position: | 7 |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | 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 |
Alias: | VMProfile |
Position: | 0 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-Windows
Anger att typen av operativsystem är Windows.
Typ: | SwitchParameter |
Position: | 1 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | 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 |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-WinRMHttp
Anger att det här operativsystemet använder HTTP WinRM.
Typ: | SwitchParameter |
Position: | 8 |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-WinRMHttps
Anger att det här operativsystemet använder HTTPS WinRM.
Typ: | SwitchParameter |
Position: | 9 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |