Set-AzureRmVMOperatingSystem
Beállítja a virtuális gép operációs rendszerének tulajdonságait.
Figyelmeztetés
Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.
Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.
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
A Set-AzureRmVMOperatingSystem parancsmag beállítja egy virtuális gép operációsrendszer-tulajdonságait. Megadhatja a bejelentkezési hitelesítő adatokat, a számítógép nevét és az operációs rendszer típusát.
Példák
1. példa: Operációs rendszer tulajdonságainak beállítása új virtuális gépekhez
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
Az első parancs biztonságos sztringgé alakítja át a jelszót, majd a $SecurePassword változóban tárolja.
További információkért írja be a következőt Get-Help ConvertTo-SecureString
:
A második parancs létrehoz egy hitelesítő adatot a felhasználó FullerP-jének és a $SecurePassword tárolt jelszónak, majd a hitelesítő adatokat a $Credential változóban tárolja.
További információkért írja be a következőt Get-Help New-Object
:
A harmadik parancs lekéri az AvailablitySet03 nevű rendelkezésre állási csoportot a ResourceGroup11 nevű erőforráscsoportban, majd az objektumot a $AvailabilitySet változóban tárolja.
A negyedik parancs létrehoz egy virtuálisgép-objektumot, majd a $VirtualMachine változóban tárolja.
A parancs nevet és méretet rendel a virtuális géphez.
A virtuális gép a $AvailabilitySet tárolt rendelkezésre állási csoporthoz tartozik.
A következő négy parancs az alábbi parancsban használandó változókhoz rendel értékeket.
Mivel ezeket a sztringeket közvetlenül a Set-AzureRmVMOperatingSystem parancsban adhatja meg, ez a módszer csak az olvashatóság érdekében használható.
Előfordulhat azonban, hogy egy ehhez hasonló megközelítést használ a szkriptekben.
Az utolsó parancs beállítja a $VirtualMachine tárolt virtuális gép operációsrendszer-tulajdonságait.
A parancs a $Credential tárolt hitelesítő adatokat használja.
A parancs egyes paraméterekhez az előző parancsokban hozzárendelt változókat használja.
Paraméterek
-ComputerName
Megadja a számítógép nevét.
Típus: | String |
Position: | 2 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Credential
PsCredential objektumként adja meg a virtuális gép felhasználónevet és jelszót.
Hitelesítő adatok beszerzéséhez használja a Get-Credential parancsmagot.
További információkért írja be a következőt Get-Help Get-Credential
:
Típus: | PSCredential |
Position: | 3 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-CustomData
Az egyéni adatok base-64 kódolású sztringét adja meg. Ez egy bináris tömbre van dekódolva, amely fájlként van mentve a virtuális gépen. A bináris tömb maximális hossza 65535 bájt.
Típus: | String |
Position: | 4 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Típus: | IAzureContextContainer |
Aliasok: | AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DisablePasswordAuthentication
Azt jelzi, hogy ez a parancsmag letiltja a jelszó-hitelesítést.
Típus: | SwitchParameter |
Position: | 5 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-DisableVMAgent
Tiltsa le a virtuálisgép-ügynök kiépítését.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-EnableAutoUpdate
Azt jelzi, hogy ez a parancsmag engedélyezi az automatikus frissítést.
Típus: | SwitchParameter |
Position: | 6 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Linux
Azt jelzi, hogy az operációs rendszer típusa Linux.
Típus: | SwitchParameter |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-ProvisionVMAgent
Azt jelzi, hogy a beállításokhoz telepíteni kell a virtuálisgép-ügynököt a virtuális gépen.
Típus: | SwitchParameter |
Position: | 5 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-TimeZone
Megadja a virtuális gép időzónáját.
Típus: | String |
Position: | 7 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-VM
Megadja azt a helyi virtuálisgép-objektumot, amelyre az operációs rendszer tulajdonságait be szeretné állítani. Virtuálisgép-objektum beszerzéséhez használja a Get-AzureRmVM parancsmagot. Hozzon létre egy virtuálisgép-objektumot a New-AzureRmVMConfig parancsmaggal.
Típus: | PSVirtualMachine |
Aliasok: | VMProfile |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Windows
Azt jelzi, hogy az operációs rendszer típusa Windows.
Típus: | SwitchParameter |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-WinRMCertificateUrl
Egy WinRM-tanúsítvány URI-ját adja meg. Ezt egy Key Vaultban kell tárolni.
Típus: | Uri |
Position: | 10 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-WinRMHttp
Azt jelzi, hogy ez az operációs rendszer HTTP WinRM-et használ.
Típus: | SwitchParameter |
Position: | 8 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-WinRMHttps
Azt jelzi, hogy ez az operációs rendszer HTTPS WinRM-t használ.
Típus: | SwitchParameter |
Position: | 9 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |