Set-AzVMOperatingSystem
Beállítja az operációs rendszer tulajdonságait egy új virtuális gép létrehozása vagy egy virtuális gép frissítése során.
Syntax
Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-ProvisionVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-ProvisionVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-WinRMHttps]
[-WinRMCertificateUrl] <Uri>
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-DisableVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-DisableVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-WinRMHttps]
[-WinRMCertificateUrl] <Uri>
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Linux]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-PatchMode <String>]
[-DisablePasswordAuthentication]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
A Set-AzVMOperatingSystem parancsmag beállítja az operációs rendszer tulajdonságait egy új virtuális gép létrehozása során. 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éphez
$SecurePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$ComputerName = "ContosoVM122"
$WinRMCertUrl = "http://keyVaultName.vault.azure.net/secrets/secretName/secretVersion"
$TimeZone = "Pacific Standard Time"
$CustomData = "echo 'Hello World'"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -WinRMHttp -WinRMHttps -WinRMCertificateUrl $WinRMCertUrl -ProvisionVMAgent -EnableAutoUpdate -TimeZone $TimeZone -PatchMode "AutomaticByPlatform"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 AvailabilitySet03 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-AzVMOperatingSystem 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.
2. példa: Operációs rendszer tulajdonságainak beállítása egy új virtuális géphez, amelyen engedélyezve van a gyakori javítás
$SecurePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$ComputerName = "ContosoVM122"
$WinRMCertUrl = "http://keyVaultName.vault.azure.net/secrets/secretName/secretVersion"
$TimeZone = "Pacific Standard Time"
$CustomData = "echo 'Hello World'"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -WinRMHttp -WinRMHttps -WinRMCertificateUrl $WinRMCertUrl -ProvisionVMAgent -EnableAutoUpdate -TimeZone $TimeZone -PatchMode "AutomaticByPlatform" -EnableHotPatchingAz 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 AvailabilitySet03 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-AzVMOperatingSystem 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.
A parancs lehetővé teszi a gyakori elérésű fájlokat a virtuális gépen.
3. példa: Operációs rendszer tulajdonságainak beállítása új Linux rendszerű virtuális gépekhez
$SecurePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$ComputerName = "ContosoVM122"
$CustomData = "echo 'Hello World'"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -PatchMode "AutomaticByPlatform"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 AvailabilitySet03 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ő két parancs az alábbi parancsban használandó változókhoz rendel értékeket.
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.
A parancs a virtuális gépen a javítás mód értékét "AutomaticByPlatform" értékre állítja.
4. példa: Állítsa be az operációs rendszer tulajdonságait hitelesítő paraméterrel, ha a virtuális gép nem rendelkezik OSProfile-val.
$rgname = <Resource Group Name>;
$loc = <Azure Region>;
New-AzResourceGroup -Name $rgname -Location $loc -Force;
# create credential
$password = <Password>;
$securePassword = $password | ConvertTo-SecureString -AsPlainText -Force;
$user = <Username>;
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);
# Setup parameters
$domainNameLabel = "d2" + $rgname;
$vmsize = 'Standard_D4s_v3';
$vmname = 'v' + $rgname;
$vnetname = "vn" + $rgname;
$vnetAddress = "10.0.0.0/16";
$subnetname = "slb" + $rgname;
$subnetAddress = "10.0.2.0/24";
$OSDiskName = $vmname + "d";
$NICName = $vmname+ "n";
$NSGName = $vmname + "nsg";
# Creating a VM using Default parameterset
$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name $subnetname -AddressPrefix $subnetAddress;
$vnet = New-AzVirtualNetwork -Name $vnetname -ResourceGroupName $rgname -Location $loc -AddressPrefix $vnetAddress -Subnet $frontendSubnet;
$nsgRuleRDP = New-AzNetworkSecurityRuleConfig -Name RDP -Protocol Tcp -Direction Inbound -Priority 1001 -SourceAddressPrefix * -SourcePortRange * -DestinationAddressPrefix * -DestinationPortRange 3389 -Access Allow;
$nsg = New-AzNetworkSecurityGroup -ResourceGroupName $rgname -Location $loc -Name $NSGName -SecurityRules $nsgRuleRDP;
$nic = New-AzNetworkInterface -Name $NICName -ResourceGroupName $rgname -Location $loc -SubnetId $vnet.Subnets[0].Id -NetworkSecurityGroupId $nsg.Id -EnableAcceleratedNetworking;
$vmConfig = New-AzVMConfig -VMName $vmname -VMSize $vmsize;
$vmConfig = Set-AzVMOperatingSystem -VM $vmConfig -Windows -ComputerName $vmname -Credential $cred;
$vmConfig = Add-AzVMNetworkInterface -VM $vmConfig -Id $nic.Id;
# Verify a VM is created.
New-AzVM -ResourceGroupName $rgname -Location $loc -VM $vmConfig;
$vm = Get-AzVM -ResourceGroupName $rgname -Name $vmname;Paraméterek
-AssessmentMode
A virtuális gép automatikus értékelési módjának értéke. A lehetséges értékek az ImageDefault és az AutomaticByPlatform.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-ComputerName
Megadja a számítógép nevét.
| Típus: | String |
| Position: | 2 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| 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ő: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-CustomData
Megadja a virtuális gépnek továbbítandó sztringet. További információ: Egyéni adatok Azure-beli virtuális gépeken. Megjegyzés: Nem ajánlott bizalmas adatokat tárolni egyéni adatokban.
| 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: | AzContext, 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 |
-EnableHotpatching
Lehetővé teszi az ügyfelek számára, hogy újraindítás nélkül javíthassák az Azure-beli virtuális gépeiket. Az enableHotpatching esetében a "provisionVMAgent" értéknek igaznak kell lennie, a "patchMode" értéknek pedig az "AutomaticByPlatform" értékre kell állítania.
| Típus: | SwitchParameter |
| Position: | Named |
| 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ő: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-PatchMode
Megadja az IaaS virtuális gép vendégen belüli javításának módját.
A lehetséges értékek a következők:
AutomaticByPlatform – A virtuális gép javítástelepítését az Azure felügyeli. -Windows vagy -Linux használatával használható. -ProvisionVMAgent szükséges. -EnableAutoUpdate szükséges a -Windowshoz való használathoz.
AutomaticByOS – A virtuális gép javítástelepítését az operációs rendszer felügyeli. A -Windows használatával használható. -ProvisionVMAgent és -EnableAutoUpdate szükséges.
Manuális – A javítások virtuális gépre való alkalmazását szabályozhatja. A -Windows használatával használható. -ProvisionVMAgent szükséges.
ImageDefault – Az operációsrendszer-lemezkép alapértelmezett beállításai által felügyelt javítástelepítés. -Linux használatával használható.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| 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. pl. "Csendes-óceáni téli idő".
A lehetséges értékek a TimeZoneInfo.GetSystemTimeZones által visszaadott időzónákból TimeZoneInfo.Id értékek.
| 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-AzVM parancsmagot. Hozzon létre egy virtuálisgép-objektumot a New-AzVMConfig 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ő: | False |
| 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 |
