Add-AzureProvisioningConfig

Referensi

Modul:: Azure

Menambahkan konfigurasi provisi untuk komputer virtual Azure.

Catatan

Cmdlet yang dirujuk dalam dokumentasi ini adalah untuk mengelola sumber daya Azure warisan yang menggunakan API Manajemen Layanan. Lihat modul Az PowerShell untuk cmdlet guna mengelola sumber daya Azure Resource Manager.

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.

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

-Certificates

Menentukan sekumpulan sertifikat yang diinstal konfigurasi ini pada komputer virtual.

Type:	CertificateSettingList
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-DisableAutomaticUpdates

Menunjukkan bahwa konfigurasi ini menonaktifkan pembaruan otomatis.

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

-DisableGuestAgent

Menunjukkan bahwa konfigurasi ini menonaktifkan agen tamu infrastruktur sebagai layanan (IaaS).

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

-DisableSSH

Menunjukkan bahwa konfigurasi ini menonaktifkan SSH.

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

-DisableWinRMHttps

Menunjukkan bahwa konfigurasi ini menonaktifkan Windows Remote Management (WinRM) di HTTPS. Secara default, WinRM diaktifkan melalui HTTPS.

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

-Domain

Menentukan nama domain akun yang memiliki izin untuk menambahkan komputer ke domain.

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

-DomainPassword

Menentukan kata sandi akun pengguna yang memiliki izin untuk menambahkan komputer ke domain.

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

-DomainUserName

Menentukan nama akun pengguna yang memiliki izin untuk menambahkan komputer ke domain.

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

-EnableWinRMHttp

Menunjukkan bahwa konfigurasi ini memungkinkan WinRM melalui HTTP.

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

-InformationAction

Menentukan bagaimana cmdlet ini merespons peristiwa informasi.

Nilai yang dapat diterima untuk parameter ini adalah:

Lanjutkan
Abaikan
Menanyakan
Lanjutkan Diam-diam
Hentikan
Tangguhkan

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Menentukan variabel informasi.

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

-JoinDomain

Menentukan nama domain yang sepenuhnya memenuhi syarat (FQDN) domain untuk bergabung.

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

-Linux

Menunjukkan bahwa konfigurasi ini membuat konfigurasi Linux.

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

-LinuxUser

Menentukan nama pengguna akun administratif Linux yang dibuat konfigurasi ini pada komputer virtual.

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

-MachineObjectOU

Menentukan nama unit organisasi (OU) yang sepenuhnya memenuhi syarat tempat konfigurasi membuat akun komputer.

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

-NoExportPrivateKey

Menunjukkan bahwa konfigurasi ini tidak mengunggah kunci privat.

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

-NoRDPEndpoint

Menunjukkan bahwa konfigurasi ini membuat komputer virtual tanpa titik akhir desktop jarak jauh.

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

-NoSSHEndpoint

Menunjukkan bahwa konfigurasi ini membuat komputer virtual tanpa titik akhir SSH.

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

-NoSSHPassword

Menunjukkan bahwa konfigurasi ini membuat komputer virtual tanpa kata sandi SSH.

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

-NoWinRMEndpoint

Menunjukkan bahwa konfigurasi ini tidak menambahkan titik akhir WinRM untuk komputer virtual.

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

-Password

Menentukan kata sandi akun administrator.

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

-Profile

Menentukan profil Azure tempat cmdlet ini dibaca. Jika Anda tidak menentukan profil, cmdlet ini akan membaca dari profil default lokal.

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

-ResetPasswordOnFirstLogon

Menunjukkan bahwa komputer virtual mengharuskan pengguna untuk mengubah kata sandi pada log masuk pertama.

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

-SSHKeyPairs

Menentukan pasangan kunci SSH.

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

-SSHPublicKeys

Menentukan kunci publik SSH.

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

-TimeZone

Menentukan zona waktu untuk komputer virtual, misalnya, Waktu Standar Pasifik atau Waktu Standar Pusat Kanada.

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

-VM

Menentukan objek komputer virtual.

Type:	IPersistentVM
Aliases:	InputObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Windows

Menunjukkan bahwa konfigurasi ini membuat komputer virtual mandiri yang menjalankan sistem operasi Windows.

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

-WindowsDomain

Menunjukkan bahwa konfigurasi ini membuat server Windows yang bergabung ke domain Direktori Aktif.

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

-WinRMCertificate

Menentukan sertifikat yang diasosiasikan konfigurasi ini ke titik akhir WinRM.

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

-X509Certificates

Menentukan array sertifikat X509 yang disebarkan ke layanan yang dihosting.

Type:	X509Certificate2[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Bagikan melalui