New-AzureQuickVM

參考

模組:: Azure

設定及建立 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

共用方式為