Set-AzVMOperatingSystem
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.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-ComputerName
Menentukan nama komputer.
Jenis: | String |
Position: | 2 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | 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
.
Jenis: | PSCredential |
Position: | 3 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | 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.
Jenis: | String |
Position: | 4 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.
Jenis: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-DisablePasswordAuthentication
Menunjukkan bahwa cmdlet ini menonaktifkan autentikasi kata sandi.
Jenis: | SwitchParameter |
Position: | 5 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-DisableVMAgent
Nonaktifkan Penyediaan Agen VM.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-EnableAutoUpdate
Menunjukkan bahwa cmdlet ini memungkinkan pembaruan otomatis.
Jenis: | SwitchParameter |
Position: | 6 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | 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'.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Linux
Menunjukkan bahwa jenis sistem operasi adalah Linux.
Jenis: | SwitchParameter |
Position: | 1 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | 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.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-ProvisionVMAgent
Menunjukkan bahwa pengaturan mengharuskan agen komputer virtual diinstal pada komputer virtual.
Jenis: | SwitchParameter |
Position: | 5 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | 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.
Jenis: | String |
Position: | 7 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | 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.
Jenis: | PSVirtualMachine |
Alias: | VMProfile |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Windows
Menunjukkan bahwa jenis sistem operasi adalah Windows.
Jenis: | SwitchParameter |
Position: | 1 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-WinRMCertificateUrl
Menentukan URI sertifikat WinRM. Ini perlu disimpan di Key Vault.
Jenis: | Uri |
Position: | 10 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-WinRMHttp
Menunjukkan bahwa sistem operasi ini menggunakan HTTP WinRM.
Jenis: | SwitchParameter |
Position: | 8 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-WinRMHttps
Menunjukkan bahwa sistem operasi ini menggunakan HTTPS WinRM.
Jenis: | SwitchParameter |
Position: | 9 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |