New-AzureQuickVM
設定及建立 Azure 虛擬機。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager(ASM) API 的舊版 Azure 資源。 建立新的資源時,不建議使用此舊版 PowerShell 模組,因為 ASM 已排定淘汰。 如需詳細資訊,請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager (ARM) 資源的建議 PowerShell 模組。
語法
New-AzureQuickVM
[-Windows]
-ServiceName <String>
[-Name <String>]
-ImageName <String>
[-Password <String>]
[-ReverseDnsFqdn <String>]
[-Location <String>]
[-AffinityGroup <String>]
[-AdminUsername <String>]
[-Certificates <CertificateSettingList>]
[-WaitForBoot]
[-DisableWinRMHttps]
[-EnableWinRMHttp]
[-WinRMCertificate <X509Certificate2>]
[-X509Certificates <X509Certificate2[]>]
[-NoExportPrivateKey]
[-NoWinRMEndpoint]
[-VNetName <String>]
[-SubnetNames <String[]>]
[-DnsSettings <DnsServer[]>]
[-HostCaching <String>]
[-AvailabilitySetName <String>]
[-InstanceSize <String>]
[-MediaLocation <String>]
[-DisableGuestAgent]
[-CustomDataFile <String>]
[-ReservedIPName <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
New-AzureQuickVM
[-Linux]
-ServiceName <String>
[-Name <String>]
-ImageName <String>
[-Password <String>]
[-ReverseDnsFqdn <String>]
[-Location <String>]
[-AffinityGroup <String>]
[-LinuxUser <String>]
[-WaitForBoot]
[-SSHPublicKeys <SSHPublicKeyList>]
[-SSHKeyPairs <SSHKeyPairList>]
[-VNetName <String>]
[-SubnetNames <String[]>]
[-DnsSettings <DnsServer[]>]
[-HostCaching <String>]
[-AvailabilitySetName <String>]
[-InstanceSize <String>]
[-MediaLocation <String>]
[-DisableGuestAgent]
[-CustomDataFile <String>]
[-ReservedIPName <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
New-AzureQuickVM Cmdlet 會設定及建立 Azure 虛擬機。 此 Cmdlet 可以將虛擬機部署到現有的 Azure 服務。 此 Cmdlet 也可以建立裝載新虛擬機的 Azure 服務。
範例
範例 1:建立虛擬機
PS C:\> New-AzureQuickVM -Windows -ServiceName "ContosoService17" -Name "VirutalMachine01" -ImageName "Image07" -Password "password" -AdminUsername "AdminMain" -WaitForBoot
此命令會建立在現有服務中執行 Windows 作業系統的虛擬機。 Cmdlet 會以指定映像上的虛擬機為基礎。 命令會 指定 WaitForBoot 參數。 因此,Cmdlet 會等候虛擬機啟動。
範例 2:使用憑證建立虛擬機
PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
PS C:\> New-AzureQuickVM -Windows -ServiceName "MySvc1" -name "MyWinVM1" -ImageName "Image07" -Password "password" -AdminUserName "AdminMain" -WinRMCertificate $certs[0] -X509Certificates $certs[1], $certs[2] -WaitForBoot
第一個命令會從存放區取得憑證,並將其儲存在 $certs 變數中。
第二個命令會建立虛擬機,以從映像在現有服務中執行 Windows 作業系統。 根據預設,WinRM Https 接聽程式會在虛擬機上啟用。 命令會 指定 WaitForBoot 參數。 因此,Cmdlet 會等候虛擬機啟動。 命令會將 WinRM 憑證和 X509Certificates 上傳至託管服務。
範例 3:建立執行 Linux 作業系統的虛擬機
PS C:\> New-AzureQuickVM -Linux -ServiceName "ContosoServiceLinux01" -Name "LinuxVirtualMachine01" -ImageName "LinuxImage01" -LinuxUser "RootMain" -Password "password" -Location "Central US"
此命令會建立虛擬機,以從映像執行Linux作業系統。 此命令會建立服務來裝載新的虛擬機。 命令會指定服務的位置。
範例 4:建立虛擬機並建立服務來裝載新的虛擬機
PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService03" -Name " VirtualMachine25" -ImageName $images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name
第一個命令會使用 Get-AzureLocation Cmdlet 取得位置,然後將它們儲存在$Locations陣列變數中。
第二個命令會使用 Get-AzureVMImage Cmdlet 取得可用的映像,然後將它們儲存在$Images陣列變數中。
最後一個命令會建立名為 VirtualMachine25 的大型虛擬機。 虛擬機會執行 Windows 作業系統。 它是以$Images中的其中一個影像為基礎。 此命令會為新的虛擬機建立名為 ContosoService03 的服務。 服務位於 $Locations 的位置。
範例 5:建立具有保留 IP 名稱的虛擬機
PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService04" -Name "VirtualMachine27" -ImageName $Images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name -ReservedIPName $ipName
第一個命令會取得位置,然後將它們儲存在$Locations陣列變數中。
第二個命令會取得可用的影像,然後將它們儲存在$Images陣列變數中。
最後一個命令會根據$Images中的其中一個映像,建立名為 VirtualMachine27 的虛擬機。 命令會在 $Locations 的位置建立服務。 虛擬機具有保留的IP名稱,先前儲存在 $ipName變數中。
參數
-AdminUsername
指定此 Cmdlet 在虛擬機上建立的系統管理員帳戶用戶名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-AffinityGroup
指定虛擬機的同質群組。 只有在此 Cmdlet 建立虛擬機的 Azure 服務時,才指定此參數或 Location 參數。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-AvailabilitySetName
指定此 Cmdlet 建立虛擬機的可用性設定組名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Certificates
指定此 Cmdlet 用來建立服務的憑證清單。
類型: | CertificateSettingList |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-CustomDataFile
指定虛擬機的數據檔。 此 Cmdlet 會將檔案的內容編碼為Base64。 檔案長度必須小於 64 KB。
如果客體操作系統是 Windows 作業系統,此 Cmdlet 會將此資料儲存為名為 %SYSTEMDRIVE%\AzureData\CustomData.bin的二進位檔。
如果客體操作系統是Linux,此 Cmdlet 會使用 ovf-env.xml 檔案來傳遞數據。 安裝會將該檔案複製到 /var/lib/waagent 目錄。 代理程式也會將Base64編碼的數據儲存在 /var/lib/waagent/CustomData 中。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableGuestAgent
指出此 Cmdlet 會停用基礎結構即服務 (IaaS) 布建客體代理程式。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableWinRMHttps
指出此 Cmdlet 會在 HTTPS 上停用 Windows 遠端管理 (WinRM)。 根據預設,WinRM 會透過 HTTPS 啟用。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DnsSettings
指定 DNS 伺服器物件的陣列,這個陣列會定義新部署的 DNS 設定。 若要建立 DnsServer 物件,請使用 New-AzureDns Cmdlet。
類型: | DnsServer[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-EnableWinRMHttp
指出此 Cmdlet 會啟用 WinRM over HTTP。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-HostCaching
指定作業系統磁碟的主機快取模式。 有效值為:
- ReadOnly
- 讀寫
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ImageName
指定此 Cmdlet 用來建立作業系統磁碟的磁碟映像名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-InformationAction
指定此 Cmdlet 如何回應資訊事件。
此參數可接受的值為:
- 繼續
- 忽略
- 詢問
- SilentlyContinue
- 停止
- 暫止
類型: | ActionPreference |
別名: | infa |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InformationVariable
指定資訊變數。
類型: | String |
別名: | iv |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InstanceSize
指定實例的大小。 有效值為:
- 特小型
- Small
- 中
- 大型
- 特大型
- A5
- A6
- A7
- A8
- A9
- 基本_A0
- 基本_A1
- 基本_A2
- Basic_A3
- Basic_A4
- 標準_D1
- 標準_D2
- Standard_D3
- 標準_D4
- 標準 D11
- 標準 D12
- 標準 D13
- 標準 D14
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Linux
指出此 Cmdlet 會建立以 Linux 為基礎的虛擬機。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-LinuxUser
指定此 Cmdlet 在虛擬機上建立的 Linux 系統管理帳戶用戶名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Location
指定裝載虛擬機的 Azure 資料中心。 如果您指定此參數,Cmdlet 會在指定的位置建立 Azure 服務。 只有在此 Cmdlet 建立虛擬機的 Azure 服務時,才指定此參數或 AffinityGroup 參數。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-MediaLocation
指定此 Cmdlet 建立虛擬機磁碟的 Azure 儲存體 位置。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Name
指定這個 Cmdlet 所建立之虛擬機的名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-NoExportPrivateKey
表示此組態不會上傳私鑰。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-NoWinRMEndpoint
指出此 Cmdlet 不會為虛擬機新增 WinRM 端點。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Password
指定系統管理帳戶的密碼。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔,此 Cmdlet 會從本機預設配置檔讀取。
類型: | AzureSMProfile |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ReservedIPName
指定保留的IP名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-ReverseDnsFqdn
指定反向 DNS 查閱的完整功能變數名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-ServiceName
指定這個 Cmdlet 新增新虛擬機的新或現有 Azure 服務名稱。
如果您指定新的服務,此 Cmdlet 會建立它。 若要建立新的服務,您必須指定 Location 或 AffinityGroup 參數。
如果您指定現有的服務,請勿指定 Location 或 AffinityGroup。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-SSHKeyPairs
指定 SSH 金鑰組。
類型: | SSHKeyPairList |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-SSHPublicKeys
指定 SSH 公鑰。
類型: | SSHPublicKeyList |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-SubnetNames
指定虛擬機子網名稱的陣列。
類型: | String[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-VNetName
指定虛擬機的虛擬網路名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WaitForBoot
表示此 Cmdlet 會等候虛擬機達到 ReadyRole 狀態。 如果虛擬機達到下列其中一個狀態,Cmdlet 會失敗:FailedStartingVM、ProvisioningFailed 或 ProvisioningTimeout。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Windows
指出此 Cmdlet 會建立 Windows 虛擬機。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-WinRMCertificate
指定此 Cmdlet 與 WinRM 端點相關聯的憑證。
類型: | X509Certificate2 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-X509Certificates
指定部署至託管服務的 X509 憑證陣列。
類型: | X509Certificate2[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |