Set-AzVMOperatingSystem

Modul:

Az.Compute

Mengatur properti sistem operasi selama pembuatan komputer virtual baru atau memperbarui komputer virtual.

Sintaks

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

Deskripsi

Cmdlet Set-AzVMOperatingSystem menetapkan properti sistem operasi selama pembuatan komputer virtual baru. Anda dapat menentukan kredensial masuk, nama komputer, dan jenis sistem operasi.

Contoh

Contoh 1: Mengatur properti sistem operasi untuk komputer virtual baru

$SecurePassword = ConvertTo-SecureString "Password" -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"

Perintah pertama mengonversi kata sandi menjadi string aman, lalu menyimpannya dalam variabel $SecurePassword. Untuk informasi selengkapnya, ketik Get-Help ConvertTo-SecureString. Perintah kedua membuat kredensial untuk pengguna FullerP dan kata sandi yang disimpan di $SecurePassword, lalu menyimpan kredensial dalam variabel $Credential. Untuk informasi selengkapnya, ketik Get-Help New-Object. Perintah ketiga mendapatkan set ketersediaan bernama AvailabilitySet03 di grup sumber daya bernama ResourceGroup11, lalu menyimpan objek tersebut dalam variabel $AvailabilitySet. Perintah keempat membuat objek komputer virtual, lalu menyimpannya dalam variabel $VirtualMachine. Perintah menetapkan nama dan ukuran ke komputer virtual. Komputer virtual milik set ketersediaan yang disimpan di $AvailabilitySet. Empat perintah berikutnya menetapkan nilai ke variabel untuk digunakan dalam perintah berikut. Karena Anda dapat menentukan string ini langsung dalam perintah Set-AzVMOperatingSystem , pendekatan ini hanya digunakan untuk keterbacaan. Namun, Anda mungkin menggunakan pendekatan seperti ini dalam skrip. Perintah akhir menetapkan properti sistem operasi untuk komputer virtual yang disimpan di $VirtualMachine. Perintah menggunakan kredensial yang disimpan dalam $Credential. Perintah menggunakan variabel yang ditetapkan dalam perintah sebelumnya untuk beberapa parameter.

Contoh 2: Mengatur properti sistem operasi untuk komputer virtual baru dengan hot patching diaktifkan

$SecurePassword = ConvertTo-SecureString "Password" -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" -EnableHotPatching

Perintah pertama mengonversi kata sandi menjadi string aman, lalu menyimpannya dalam variabel $SecurePassword. Untuk informasi selengkapnya, ketik Get-Help ConvertTo-SecureString. Perintah kedua membuat kredensial untuk pengguna FullerP dan kata sandi yang disimpan di $SecurePassword, lalu menyimpan kredensial dalam variabel $Credential. Untuk informasi selengkapnya, ketik Get-Help New-Object. Perintah ketiga mendapatkan set ketersediaan bernama AvailabilitySet03 di grup sumber daya bernama ResourceGroup11, lalu menyimpan objek tersebut dalam variabel $AvailabilitySet. Perintah keempat membuat objek komputer virtual, lalu menyimpannya dalam variabel $VirtualMachine. Perintah menetapkan nama dan ukuran ke komputer virtual. Komputer virtual milik set ketersediaan yang disimpan di $AvailabilitySet. Empat perintah berikutnya menetapkan nilai ke variabel untuk digunakan dalam perintah berikut. Karena Anda dapat menentukan string ini langsung dalam perintah Set-AzVMOperatingSystem , pendekatan ini hanya digunakan untuk keterbacaan. Namun, Anda mungkin menggunakan pendekatan seperti ini dalam skrip. Perintah akhir menetapkan properti sistem operasi untuk komputer virtual yang disimpan di $VirtualMachine. Perintah menggunakan kredensial yang disimpan dalam $Credential. Perintah menggunakan variabel yang ditetapkan dalam perintah sebelumnya untuk beberapa parameter. Perintah ini memungkinkan Hotpatching pada komputer virtual.

Contoh 3: Mengatur properti sistem operasi untuk komputer virtual Linux baru

$SecurePassword = ConvertTo-SecureString "Password" -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"

Perintah pertama mengonversi kata sandi menjadi string aman, lalu menyimpannya dalam variabel $SecurePassword. Untuk informasi selengkapnya, ketik Get-Help ConvertTo-SecureString. Perintah kedua membuat kredensial untuk pengguna FullerP dan kata sandi yang disimpan di $SecurePassword, lalu menyimpan kredensial dalam variabel $Credential. Untuk informasi selengkapnya, ketik Get-Help New-Object. Perintah ketiga mendapatkan set ketersediaan bernama AvailabilitySet03 di grup sumber daya bernama ResourceGroup11, lalu menyimpan objek tersebut dalam variabel $AvailabilitySet. Perintah keempat membuat objek komputer virtual, lalu menyimpannya dalam variabel $VirtualMachine. Perintah menetapkan nama dan ukuran ke komputer virtual. Komputer virtual milik set ketersediaan yang disimpan di $AvailabilitySet. Dua perintah berikutnya menetapkan nilai ke variabel untuk digunakan dalam perintah berikut. Perintah akhir menetapkan properti sistem operasi untuk komputer virtual yang disimpan di $VirtualMachine. Perintah menggunakan kredensial yang disimpan dalam $Credential. Perintah menggunakan variabel yang ditetapkan dalam perintah sebelumnya untuk beberapa parameter. Perintah mengatur nilai mode patch pada komputer virtual ke "AutomaticByPlatform".

Parameter

-AssessmentMode

Nilai mode penilaian otomatis untuk komputer virtual. Nilai yang mungkin adalah ImageDefault dan AutomaticByPlatform.

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

-ComputerName

Menentukan nama komputer.

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

-Credential

Menentukan nama pengguna dan kata sandi untuk komputer virtual sebagai objek PSCredential . Untuk mendapatkan kredensial, gunakan cmdlet Get-Credential. Untuk informasi selengkapnya, ketik Get-Help Get-Credential.

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

-CustomData

Menentukan string yang akan diteruskan ke komputer virtual. Untuk informasi selengkapnya, lihat Data Kustom di Azure VM. Catatan: Tidak disarankan untuk menyimpan informasi sensitif dalam data kustom.

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

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

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

-DisablePasswordAuthentication

Menunjukkan bahwa cmdlet ini menonaktifkan autentikasi kata sandi.

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

-DisableVMAgent

Nonaktifkan Penyediaan Agen VM.

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

-EnableAutoUpdate

Menunjukkan bahwa cmdlet ini memungkinkan pembaruan otomatis.

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

-EnableHotpatching

Memungkinkan pelanggan untuk menambal Azure VM mereka tanpa memerlukan boot ulang. Untuk enableHotpatching, 'provisionVMAgent' harus diatur ke true dan 'patchMode' harus diatur ke 'AutomaticByPlatform'.

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

-Linux

Menunjukkan bahwa jenis sistem operasi adalah Linux.

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

-PatchMode

Menentukan mode patching dalam tamu ke komputer virtual IaaS.

Kemungkinan nilai adalah:
AutomaticByPlatform - Penginstalan patch untuk komputer virtual akan dikelola oleh Azure. Gunakan dengan -Windows atau -Linux. Memerlukan -ProvisionVMAgent. Memerlukan -EnableAutoUpdate saat digunakan dengan -Windows.
AutomaticByOS - Penginstalan patch untuk komputer virtual akan dikelola oleh OS. Gunakan dengan -Windows. Memerlukan -ProvisionVMAgent dan -EnableAutoUpdate.
Manual - Anda mengontrol aplikasi patch ke komputer virtual. Gunakan dengan -Windows. Memerlukan -ProvisionVMAgent.
ImageDefault - Penginstalan patch yang dikelola oleh pengaturan default pada gambar OS. Gunakan dengan -Linux.

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

-ProvisionVMAgent

Menunjukkan bahwa pengaturan mengharuskan agen komputer virtual diinstal pada komputer virtual.

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

-TimeZone

Menentukan zona waktu komputer virtual. misalnya "Waktu Standar Pasifik".
Nilai yang mungkin dapat TimeZoneInfo.Id nilai dari zona waktu yang dikembalikan oleh TimeZoneInfo.GetSystemTimeZones.

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

-VM

Menentukan objek komputer virtual lokal untuk mengatur properti sistem operasi. Untuk mendapatkan objek komputer virtual, gunakan cmdlet Get-AzVM. Buat objek komputer virtual dengan menggunakan cmdlet New-AzVMConfig.

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

-Windows

Menunjukkan bahwa jenis sistem operasi adalah Windows.

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

-WinRMCertificateUrl

Menentukan URI sertifikat WinRM. Ini perlu disimpan di Key Vault.

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

-WinRMHttp

Menunjukkan bahwa sistem operasi ini menggunakan HTTP WinRM.

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

-WinRMHttps

Menunjukkan bahwa sistem operasi ini menggunakan HTTPS WinRM.

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

Input

PSVirtualMachine

SwitchParameter

String

PSCredential

Uri

Output

PSVirtualMachine

Link Terkait

• Get-AzVM
• New-AzVMConfig