Add-AzureProvisioningConfig
Menambahkan konfigurasi provisi untuk komputer virtual Azure.
Catatan
Cmdlet yang dirujuk dalam dokumentasi ini adalah untuk mengelola sumber daya Azure warisan yang menggunakan API Azure Service Manager (ASM). Modul PowerShell warisan ini tidak disarankan saat membuat sumber daya baru karena ASM dijadwalkan untuk dihentikan. Untuk informasi selengkapnya, lihat Penghentian Azure Service Manager.
Modul Az PowerShell adalah modul PowerShell yang direkomendasikan untuk mengelola sumber daya Azure Resource Manager (ARM) dengan PowerShell.
Sintaks
Add-AzureProvisioningConfig
-VM <IPersistentVM>
[-DisableGuestAgent]
[-CustomDataFile <String>]
[-Windows]
[-AdminUsername <String>]
[-Password <String>]
[-ResetPasswordOnFirstLogon]
[-DisableAutomaticUpdates]
[-NoRDPEndpoint]
[-TimeZone <String>]
[-Certificates <CertificateSettingList>]
[-EnableWinRMHttp]
[-DisableWinRMHttps]
[-WinRMCertificate <X509Certificate2>]
[-X509Certificates <X509Certificate2[]>]
[-NoExportPrivateKey]
[-NoWinRMEndpoint]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Add-AzureProvisioningConfig
-VM <IPersistentVM>
[-DisableGuestAgent]
[-Linux]
[-LinuxUser <String>]
[-DisableSSH]
[-NoSSHEndpoint]
[-NoSSHPassword]
[-SSHPublicKeys <SSHPublicKeyList>]
[-SSHKeyPairs <SSHKeyPairList>]
[-CustomDataFile <String>]
[-Password <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Add-AzureProvisioningConfig
-VM <IPersistentVM>
[-DisableGuestAgent]
[-CustomDataFile <String>]
-AdminUsername <String>
[-WindowsDomain]
[-Password <String>]
[-ResetPasswordOnFirstLogon]
[-DisableAutomaticUpdates]
[-NoRDPEndpoint]
[-TimeZone <String>]
[-Certificates <CertificateSettingList>]
-JoinDomain <String>
-Domain <String>
-DomainUserName <String>
-DomainPassword <String>
[-MachineObjectOU <String>]
[-EnableWinRMHttp]
[-DisableWinRMHttps]
[-WinRMCertificate <X509Certificate2>]
[-X509Certificates <X509Certificate2[]>]
[-NoExportPrivateKey]
[-NoWinRMEndpoint]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Deskripsi
Cmdlet Add-AzureProvisioningConfig menambahkan informasi konfigurasi provisi ke konfigurasi komputer virtual Azure. Anda dapat menggunakan objek konfigurasi untuk membuat komputer virtual.
Cmdlet ini mendukung konfigurasi provisi yang berbeda, termasuk server Windows mandiri, server Windows yang bergabung ke domain Direktori Aktif, dan server berbasis Linux.
Untuk membuat server yang bergabung dengan domain Direktori Aktif, tentukan nama domain yang sepenuhnya memenuhi syarat dari domain Direktori Aktif dan kredensial domain pengguna yang memiliki izin untuk bergabung dengan komputer virtual ke domain.
Contoh
Contoh 1: Membuat komputer virtual mandiri
PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" | New-AzureVM -ServiceName "ContosoService"
Perintah ini membuat objek konfigurasi komputer virtual dengan menggunakan cmdlet New-AzureVMConfig . Perintah meneruskan objek tersebut ke cmdlet saat ini dengan menggunakan operator alur. Cmdlet saat ini menambahkan konfigurasi provisi untuk komputer virtual yang menjalankan sistem operasi Windows. Konfigurasi mencakup nama pengguna dan kata sandi administrator. Perintah meneruskan konfigurasi ke cmdlet New-AzureVM , yang membuat komputer virtual.
Contoh 2: Membuat komputer virtual yang bergabung dengan domain
PS C:\> New-AzureVMConfig -Name "DomainVM" -InstanceSize Small -ImageName "Image09" | Add-AzureProvisioningConfig -WindowsDomain -Password "password" -AdminUsername "AdminMain" -ResetPasswordOnFirstLogon -JoinDomain "contoso.com" -Domain "contoso" -DomainUserName "DomainAdminUser" -DomainPassword "DomainPassword" -MachineObjectOU 'OU=AzureVMs,DC=contoso,DC=com' | New-AzureVM -ServiceName "ContosoService"
Perintah ini membuat objek konfigurasi komputer virtual, lalu meneruskannya ke cmdlet saat ini. Cmdlet saat ini menambahkan konfigurasi provisi untuk komputer virtual yang akan digabungkan dengan domain contoso. Perintah ini mencakup nama pengguna dan kata sandi yang diperlukan untuk bergabung dengan komputer virtual ke domain. Konfigurasi mengharuskan pengguna untuk mengubah kata sandi pengguna pada masuk pertama. Perintah membuat komputer virtual berdasarkan objek provisi.
Contoh 3: Membuat komputer virtual berbasis Linux
PS C:\> New-AzureVMConfig -Name "LinuxVM" -InstanceSize Small -ImageName "LinuxImage03" | Add-AzureProvisioningConfig -Linux -LinuxUser "LinuxRoot" -Password "password" | New-AzureVM -ServiceName "ContosoService"
Perintah ini membuat objek konfigurasi komputer virtual, lalu meneruskannya ke cmdlet saat ini. Cmdlet saat ini menambahkan konfigurasi provisi untuk komputer virtual yang menjalankan sistem operasi Linux. Konfigurasi mencakup nama pengguna root dan kata sandi. Perintah membuat komputer virtual berdasarkan objek provisi.
Contoh 4: Membuat komputer virtual yang menyertakan sertifikat untuk WinRM
PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image11" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -WinRMCertificate $certs[0] -X509Certificates $certs[1], $certs[2] | New-AzureVM -ServiceName "ContosoService" -WaitForBoot
Perintah pertama mendapatkan sertifikat dari penyimpanan sertifikat, lalu menyimpannya dalam variabel array $certs.
Perintah kedua membuat objek konfigurasi komputer virtual, lalu meneruskannya ke cmdlet saat ini. Cmdlet saat ini menambahkan konfigurasi provisi yang menyertakan sertifikat untuk WinRM. Perintah membuat komputer virtual berdasarkan objek provisi.
Contoh 5: Membuat komputer virtual yang mengaktifkan WinRM melalui HTTP
PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image14" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -EnableWinRMHttp | New-AzureVM -ServiceName "ContosoService" -WaitForBoot
Perintah ini membuat objek konfigurasi komputer virtual, lalu meneruskannya ke cmdlet saat ini. Cmdlet saat ini menambahkan konfigurasi provisi yang mengaktifkan WinRM melalui HTTP. Perintah membuat komputer virtual berdasarkan objek provisi.
Contoh 6: Buat komputer virtual yang menonaktifkan WinRM melalui HTTPS
PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -DisableWinRMHttps | New-AzureVM -ServiceName "ContosoService" -WaitForBoot
Perintah ini membuat objek konfigurasi komputer virtual, lalu meneruskannya ke cmdlet saat ini. Cmdlet saat ini menambahkan konfigurasi provisi yang menonaktifkan WinRM melalui HTTPS. Perintah membuat komputer virtual berdasarkan objek provisi.
Contoh 7: Membuat komputer virtual tanpa ekspor kunci
PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -X509Certificates $certs[0], $certs[1] -NoExportPrivateKey | New-AzureVM -ServiceName "ContosoService" -WaitForBoot
Perintah pertama mendapatkan sertifikat dari penyimpanan sertifikat, lalu menyimpannya dalam variabel array $certs.
Perintah kedua membuat objek konfigurasi komputer virtual, lalu meneruskannya ke cmdlet saat ini. Cmdlet saat ini menambahkan konfigurasi provisi untuk komputer virtual yang menyertakan sertifikat dan tidak mengekspor kunci privat. Perintah membuat komputer virtual berdasarkan objek provisi.
Parameter
-AdminUsername
Menentukan nama pengguna akun Administrator yang dibuat konfigurasi ini pada komputer virtual.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Certificates
Menentukan sekumpulan sertifikat yang diinstal konfigurasi ini pada komputer virtual.
Jenis: | CertificateSettingList |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-CustomDataFile
Menentukan file data untuk komputer virtual. Cmdlet ini mengodekan konten file sebagai Base64. Panjang file harus kurang dari 64 kilobyte.
Jika sistem operasi tamu adalah sistem operasi Windows, konfigurasi ini menyimpan data ini sebagai file biner bernama %SYSTEMDRIVE%\AzureData\CustomData.bin.
Jika sistem operasi tamu adalah Linux, konfigurasi ini meneruskan data dengan menggunakan file ovf-env.xml. Konfigurasi menyalin file tersebut ke direktori /var/lib/waagent. Agen juga menyimpan data yang dikodekan Base64 di /var/lib/waagent/CustomData.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-DisableAutomaticUpdates
Menunjukkan bahwa konfigurasi ini menonaktifkan pembaruan otomatis.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-DisableGuestAgent
Menunjukkan bahwa konfigurasi ini menonaktifkan agen tamu infrastruktur sebagai layanan (IaaS).
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-DisableSSH
Menunjukkan bahwa konfigurasi ini menonaktifkan SSH.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-DisableWinRMHttps
Menunjukkan bahwa konfigurasi ini menonaktifkan Windows Remote Management (WinRM) di HTTPS. Secara default, WinRM diaktifkan melalui HTTPS.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Domain
Menentukan nama domain akun yang memiliki izin untuk menambahkan komputer ke domain.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-DomainPassword
Menentukan kata sandi akun pengguna yang memiliki izin untuk menambahkan komputer ke domain.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-DomainUserName
Menentukan nama akun pengguna yang memiliki izin untuk menambahkan komputer ke domain.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-EnableWinRMHttp
Menunjukkan bahwa konfigurasi ini memungkinkan WinRM melalui HTTP.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-InformationAction
Menentukan bagaimana cmdlet ini merespons peristiwa informasi.
Nilai yang dapat diterima untuk parameter ini adalah:
- Lanjutkan
- Abaikan
- Tanya
- Lanjutkan Diam-diam
- Stop
- Tangguhkan
Jenis: | ActionPreference |
Alias: | infa |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-InformationVariable
Menentukan variabel informasi.
Jenis: | String |
Alias: | iv |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-JoinDomain
Menentukan nama domain yang sepenuhnya memenuhi syarat (FQDN) domain untuk bergabung.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Linux
Menunjukkan bahwa konfigurasi ini membuat konfigurasi Linux.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-LinuxUser
Menentukan nama pengguna akun administratif Linux yang dibuat konfigurasi ini pada komputer virtual.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-MachineObjectOU
Menentukan nama unit organisasi (OU) yang sepenuhnya memenuhi syarat tempat konfigurasi membuat akun komputer.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-NoExportPrivateKey
Menunjukkan bahwa konfigurasi ini tidak mengunggah kunci privat.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-NoRDPEndpoint
Menunjukkan bahwa konfigurasi ini membuat komputer virtual tanpa titik akhir desktop jarak jauh.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-NoSSHEndpoint
Menunjukkan bahwa konfigurasi ini membuat komputer virtual tanpa titik akhir SSH.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-NoSSHPassword
Menunjukkan bahwa konfigurasi ini membuat komputer virtual tanpa kata sandi SSH.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-NoWinRMEndpoint
Menunjukkan bahwa konfigurasi ini tidak menambahkan titik akhir WinRM untuk komputer virtual.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Password
Menentukan kata sandi akun administrator.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Profile
Menentukan profil Azure tempat cmdlet ini dibaca. Jika Anda tidak menentukan profil, cmdlet ini akan membaca dari profil default lokal.
Jenis: | AzureSMProfile |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ResetPasswordOnFirstLogon
Menunjukkan bahwa komputer virtual mengharuskan pengguna untuk mengubah kata sandi pada log masuk pertama.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-SSHKeyPairs
Menentukan pasangan kunci SSH.
Jenis: | SSHKeyPairList |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-SSHPublicKeys
Menentukan kunci publik SSH.
Jenis: | SSHPublicKeyList |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-TimeZone
Menentukan zona waktu untuk komputer virtual, misalnya, Waktu Standar Pasifik atau Waktu Standar Pusat Kanada.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-VM
Menentukan objek komputer virtual.
Jenis: | IPersistentVM |
Alias: | InputObject |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Windows
Menunjukkan bahwa konfigurasi ini membuat komputer virtual mandiri yang menjalankan sistem operasi Windows.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-WindowsDomain
Menunjukkan bahwa konfigurasi ini membuat server Windows yang bergabung ke domain Direktori Aktif.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-WinRMCertificate
Menentukan sertifikat yang diasosiasikan konfigurasi ini ke titik akhir WinRM.
Jenis: | X509Certificate2 |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-X509Certificates
Menentukan array sertifikat X509 yang disebarkan ke layanan yang dihosting.
Jenis: | X509Certificate2[] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |