共用方式為

Add-AzureProvisioningConfig

  • 參考
模組:
Azure

新增 Azure 虛擬機器的布建組態。

注意

本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet，請參閱 Az PowerShell 模組 。

Syntax

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>]

Description

Add-AzureProvisioningConfig Cmdlet 會將布建組態資訊新增至 Azure 虛擬機器組態。 您可以使用組態物件來建立虛擬機器。

此 Cmdlet 支援不同的布建組態，包括獨立 Windows 伺服器、已加入 Active Directory 網域的 Windows 伺服器，以及以 Linux 為基礎的伺服器。

若要建立已加入 Active Directory 網域的伺服器，請指定 Active Directory 網域的完整功能變數名稱，以及有權將虛擬機器加入網域的使用者網域認證。

範例

範例 1：建立獨立虛擬機器

PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" | New-AzureVM -ServiceName "ContosoService"

此命令會使用 New-AzureVMConfig Cmdlet 建立虛擬機器組態物件。 命令會使用管線運算子，將該物件傳遞至目前的 Cmdlet。 目前的 Cmdlet 會為執行 Windows 作業系統的虛擬機器新增布建組態。 組態包含系統管理員使用者名稱和密碼。 此命令會將組態傳遞至 New-AzureVM Cmdlet，以建立虛擬機器。

範例 2：建立已加入網域的虛擬機器

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"

此命令會建立虛擬機器組態物件，然後將它傳遞給目前的 Cmdlet。 目前的 Cmdlet 會新增要加入 contoso 網域之虛擬機器的布建組態。 此命令包含將虛擬機器加入網域所需的使用者名稱和密碼。 設定要求使用者在第一次登入時變更使用者密碼。 命令會根據布建物件建立虛擬機器。

範例 3：建立以 Linux 為基礎的虛擬機器

PS C:\> New-AzureVMConfig -Name "LinuxVM" -InstanceSize Small -ImageName "LinuxImage03" | Add-AzureProvisioningConfig -Linux -LinuxUser "LinuxRoot" -Password "password" | New-AzureVM -ServiceName "ContosoService"

此命令會建立虛擬機器組態物件，然後將它傳遞給目前的 Cmdlet。 目前的 Cmdlet 會為執行 Linux 作業系統的虛擬機器新增布建組態。 組態包含根使用者名稱和密碼。 命令會根據布建物件建立虛擬機器。

範例 4：建立包含 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

第一個命令會從憑證存放區取得憑證，然後將它們儲存在$certs陣列變數中。

第二個命令會建立虛擬機器組態物件，然後將它傳遞給目前的 Cmdlet。 目前的 Cmdlet 會新增布建組態，其中包含 WinRM 的憑證。 命令會根據布建物件建立虛擬機器。

範例 5：建立已透過 HTTP 啟用 WinRM 的虛擬機器

PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image14" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -EnableWinRMHttp | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

此命令會建立虛擬機器組態物件，然後將它傳遞給目前的 Cmdlet。 目前的 Cmdlet 會新增透過 HTTP 啟用 WinRM 的布建組態。 命令會根據布建物件建立虛擬機器。

範例 6：建立已透過 HTTPS 停用 WinRM 的虛擬機器

PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -DisableWinRMHttps | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

此命令會建立虛擬機器組態物件，然後將它傳遞給目前的 Cmdlet。 目前的 Cmdlet 會新增布建組態，以停用 WinRM over HTTPS。 命令會根據布建物件建立虛擬機器。

範例 7：建立沒有金鑰匯出的虛擬機器

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

第一個命令會從憑證存放區取得憑證，然後將它們儲存在$certs陣列變數中。

第二個命令會建立虛擬機器組態物件，然後將它傳遞給目前的 Cmdlet。 目前的 Cmdlet 會為包含憑證且不會匯出私密金鑰的虛擬機器新增布建組態。 命令會根據布建物件建立虛擬機器。

參數

-AdminUsername

指定此組態在虛擬機器上建立的系統管理員帳戶使用者名稱。

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

-Certificates

指定此組態在虛擬機器上安裝的一組憑證。

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

-CustomDataFile

指定虛擬機器的資料檔案。 此 Cmdlet 會將檔案的內容編碼為 Base64。 檔案長度必須小於 64 KB。

如果客體作業系統是 Windows 作業系統，此組態會將此資料儲存為名為 %SYSTEMDRIVE%\AzureData\CustomData.bin 的二進位檔。

如果客體作業系統是 Linux，此組態會使用 ovf-env.xml 檔案傳遞資料。 組態會將該檔案複製到 /var/lib/waagent 目錄。 代理程式也會將 Base64 編碼的資料儲存在 /var/lib/waagent/CustomData 中。

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

-DisableAutomaticUpdates

表示此組態會停用自動更新。

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

-DisableGuestAgent

表示此設定會停用基礎結構即服務 （IaaS） 客體代理程式。

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

-DisableSSH

表示此組態會停用 SSH。

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

-DisableWinRMHttps

表示此設定會停用 HTTPS 上的 Windows 遠端系統管理 （WinRM）。 根據預設，WinRM 會透過 HTTPS 啟用。

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

-Domain

指定有權將電腦新增至網域之帳戶的功能變數名稱。

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

-DomainPassword

指定具有將電腦新增至網域之許可權的使用者帳戶密碼。

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

-DomainUserName

指定有權將電腦新增至網域的使用者帳戶名稱。

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

-EnableWinRMHttp

表示此設定會啟用 WinRM over HTTP。

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

-InformationAction

指定此 Cmdlet 如何回應資訊事件。

此參數可接受的值為：

  • 繼續
  • 忽略
  • 詢問
  • SilentlyContinue
  • 停止
  • 暫止
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

指定資訊變數。

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

-JoinDomain

指定要加入之網域的完整功能變數名稱 （FQDN）。

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

-Linux

表示此組態會建立 Linux 組態。

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

-LinuxUser

指定此設定在虛擬機器上建立之 Linux 系統管理帳戶的使用者名稱。

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

-MachineObjectOU

指定組態建立電腦帳戶的組織單位 （OU） 完整名稱。

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

-NoExportPrivateKey

表示此組態不會上傳私密金鑰。

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

-NoRDPEndpoint

表示此組態會建立沒有遠端桌面端點的虛擬機器。

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

-NoSSHEndpoint

表示此組態會建立沒有 SSH 端點的虛擬機器。

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

-NoSSHPassword

表示此組態會建立沒有 SSH 密碼的虛擬機器。

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

-NoWinRMEndpoint

表示此設定不會為虛擬機器新增 WinRM 端點。

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

-Password

指定系統管理員帳戶的密碼。

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

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設設定檔讀取。

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

-ResetPasswordOnFirstLogon

指出虛擬機器要求使用者在第一次登入時變更密碼。

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

-SSHKeyPairs

指定 SSH 金鑰組。

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

-SSHPublicKeys

指定 SSH 公開金鑰。

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

-TimeZone

指定虛擬機器的時區，例如太平洋標準時間或加拿大中部標準時間。

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

-VM

指定虛擬機器物件。

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

-Windows

表示此組態會建立執行 Windows 作業系統的獨立虛擬機器。

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

-WindowsDomain

指出此組態會建立已加入 Active Directory 網域的 Windows 伺服器。

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

-WinRMCertificate

指定此組態與 WinRM 端點相關聯的憑證。

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

-X509Certificates

指定部署至託管服務的 X509 憑證陣列。

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