銷售: 1-800-867-1380

更新角色

更新日期: 2015年4月

Update Role 作業會更新指定之虛擬機器的組態。

請使用下列格式指定 Update Role 要求。以訂用帳戶識別碼取代 <subscription-id>、以雲端服務的名稱取代 <cloudservice-name>、以部署的名稱取代 <deployment-name>,並以虛擬機器的名稱取代 <role-name>

 

方法 要求 URI

PUT

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/roles/<role-name>

��必須確定對管理服務發出的要求是安全的。如需其他詳細資訊,請參閱驗證服務管理要求

無。

下表描述要求標頭。

 

���求標頭 說明

x-ms-version

必要項。指定用於這個要求的作業版本。此標頭應該設定為 2012/3/1 或更高版本。如需版本設定標頭的詳細資訊,請參閱服務管理版本設定

要求主體的格式如下:

    
<PersistentVMRole xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ConfigurationSets>
    <ConfigurationSet>
      <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>
      <InputEndpoints>
        <InputEndpoint>
          <LoadBalancedEndpointSetName>name-of-loadbalanced-set</LoadBalancedEndpointSetName>
          <LocalPort>local-port-number</LocalPort>
          <Name>name-of-endpoint</Name>
          <Port>external-port-number</Port>
          <LoadBalancerProbe>
            <Path>path-of-probe</Path>
            <Port>port-assigned-to-probe</Port>
            <Protocol>probe-protocol</Protocol>
          </LoadBalancerProbe>     
          <Protocol>endpoint-protocol</Protocol>
          <EnableDirectServerReturn>enable-direct-server-return</EnableDirectServerReturn>
          <EndpointAcl>
            <Rules>
              <Rule>
                <Order>priority-of-the-rule</Order>
                <Action>permit-rule</Action>
                <RemoteSubnet>subnet-of-the-rule</RemoteSubnet>
                <Description>description-of-the-rule</Description>
              </Rule>
            </Rules>
          </EndpointAcl>
          <LoadBalancerName>name-of-internal-loadbalancer</LoadBalancerName>
          <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>
        </InputEndpoint>
      </InputEndpoints>
      <SubnetNames>
        <SubnetName>name-of-subnet</SubnetName>
      </SubnetNames>
      <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress>
      <NetworkSecurityGroup>network-security-group</NetworkSecurityGroup>
      <PublicIPs>
        <PublicIP>
          <Name>name-of-public-ip</Name>
          <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>
        <PublicIP>
      <PublicIPs>
    <ConfigurationSet>
  </ConfigurationSets>
  <ResourceExtensionReferences>
    <ResourceExtensionReference>
      <ReferenceName>name-of-reference</ReferenceName>
      <Publisher>name-of-publisher</Publisher>
      <Name>name-of-extension</Name>
      <Version>version-of-extension</Version>
      <ResourceExtensionParameterValues>
        <ResourceExtensionParameterValue>
          <Key>name-of-parameter-key</Key>
          <Value>parameter-value</Value>
          <Type>type-of-parameter</Type>
        </ResourceExtensionParameterValue>
      </ResourceExtensionParameterValues>
      <State>state-of-resource</State>
      <Certificates>
        <Certificate>
          <Thumbprint>certificate-thumbprint</Thumbprint>
          <ThumbprintAlgorithm>certificate-algorithm</ThumbprintAlgorithm>
        </Certificate>
      </Certificates>
    </ResourceExtensionReference>
    </ForceUpdate>force-update</ForceUpdate>
  </ResourceExtensionReferences>
  <AvailabilitySetName>name-of-availability-set</AvailabilitySetName>
  <DataVirtualHardDisks>
    <DataVirtualHardDisk>
      <HostCaching>caching-mode</HostCaching>
      <DiskName>name-of-disk</DiskName>
      <Lun>logical-unit-number</Lun>
      <LogicalDiskSizeInGB>size-in-gb-of-data-disk</LogicalDiskSizeInGB>
      <MediaLink>path-to-vhd</MediaLink>
    </DataVirtualHardDisk>
  </DataVirtualHardDisks>
  <OSVirtualHardDisk>
    <HostCaching>caching-mode</HostCaching>
    <DiskLabel>label-of-operating-system-disk</DiskLabel>
    <MediaLink>path-to-vhd</MediaLink>
    <SourceImageName>name-of-source-image</SourceImageName>
  </OSVirtualHardDisk>
  <RoleSize>size-of-virtual-machine</RoleSize>
  <ProvisionGuestAgent>install-an-agent</ProvisionGuestAgent>   
</PersistentVMRole>

下表說明要求主體的元素。

 

元素名稱 說明

ConfigurationSets

選擇性。包含定義系統及應用程式設定之組態集的集合。

ResourceExtensionReferences

選擇性。包含要安裝於虛擬機器上的資源擴充功能集合。當 ProvisionGuestAgent 設定為 true 時才會使用此元素。

必須使用 01.11.13 版或更高版本,才能使用 ResourceExtensionReferences 元素。

AvailabilitySetName

選擇性。指定虛擬機器集合的名稱。指定於相同可用性設定組的虛擬機器會配置到不同的節點,以便盡可能提高可用性。

DataVirtualHardDisks

選擇性。包含用以將資料磁碟加入至虛擬機器的參數。如需有關資料磁碟的詳細資訊,請參閱管理磁碟及映像

OSVirtualHardDisk

必要項。包含用以建立虛擬機器之作業系統磁碟的參數。

RoleSize

選擇性。指定虛擬機器的大小。預設的大小是 Small (小型)。如需有關虛擬機器大小的詳細資訊,請參閱 Azure 的虛擬機器和雲端服務大小

ProvisionGuestAgent

選擇性。指出虛擬機器上是否已安裝 VM 代理程式。若要在虛擬機器上執行資源延伸模組,必須安裝此代理程式。

可能的值為:

  • true

  • false

如果已在虛擬機器上安裝 VM 代理程式,則值不可為 false

包含定義系統及應用程式設定之組態集的集合。

 

元素名稱 說明

ConfigurationSetType

必要項。您只能更新 NetworkConfiguration 組態集的設定。

InputEndpoints

選擇性。包含虛擬機器之外部端點的集合。

SubnetNames

部署所屬之虛擬網路子網路名稱的清單。

注意:空清單無法進行更新。

如果此元素與 StaticVirtualNetworkIPAddress 元素一起使用,則無法對此參數進行更新。

StaticVirtualNetworkIPAddress

選擇性。為虛擬網路中的虛擬機器指定內部 IP 位址。如果您指定這個元素,您也只能利用已定義的一組子網路指定 SubnetNames 元素。在此元素中指定的 IP 位址必須屬於 SubnetNames 定義的子網路,並且不可為此子網路中的前四個 IP 位址或最後一個 IP 位址。

必須使用 01.11.13 版或更高版本,才能使用 StaticVirtualNetworkIPAddress 元素。

NetworkSecurityGroup

選擇性。代表與虛擬機器相關聯的網路安全性群組名稱。網路安全性群組必須存在於訂用帳戶內容中,並在部署虛擬機器的相同區域中建立。

必須使用 01.10.14 版或更高版本,才能使用 NetworkSecurityGroup 元素。

PublicIPs

選擇性。包含除了虛擬機器的預設虛擬 IP 位址以外可使用的公用 IP 位址。

必須使用 01.05.14 版或更高版本,才能使用 PublicIPs 元素。

包含虛擬機器之外部端點的集合。

 

元素名稱 說明

InputEndpoint

必要項。指定屬性以定義虛擬機器的外部端點。

LoadBalancedEndpointSetName

選擇性。指定一組負載平衡端點的名稱。針對端點指定這個元素,就會將該端點加入至集合。

如果您要加入端點以使用遠端桌面連接到虛擬機器,請勿設定此屬性。

note附註
在虛擬機器的範圍內,端點名稱必須是唯一的。

LocalPort

必要項。指定虛擬機器所接聽的內部連接埠。

名稱

必要項。指定外部端點的名稱。

Port

必要項。指定要用於端點的外部連接埠。

LoadBalancerProbe

選擇性。包含定義端點設定的屬性,以供負載平衡器用於監視虛擬機器的可用性,然後再將流量轉送至端點。

通訊協定

必要項。指定端點的傳輸通訊協定。

可能的值為:

  • TCP

  • UDP

預設值是 false

EnableDirectServerReturn

選擇性。指定端點是否使用 Direct Server Return。RDP、SSH 或 WinRM 端點不支援 EnableDirectServerReturn 元素,且在端點的公用連接埠和本機連接埠不同時也不支援。您無法停用端點的 EnableDirectServerReturn。如果 EnableDirectServerReturn 設定為 true,您就無法更新 Protocol 的值。建議只在為 SQL Server 及 AlwaysOn 可用性群組設定虛擬機器時使用此元素。如需詳細資訊,請參閱 Azure 虛擬機器中的 SQL Server 高可用性和災害復原

可能的值為:

  • true

  • false

預設值是 false

EndpointAcl

選擇性。包含用以控制將網路流量送至端點的規則集合。

必須使用 2013-06-01 版或更高版本,才能使用 EndpointAcl 元素。

LoadBalancerName

選擇性。指定與此端點相關聯之內部負載平衡器的名稱。內部負載平衡器名稱在 LoadBalancers 中指定。

必須使用 01.05.14 版或更高版本,才能使用 LoadBalancerName 元素。

IdleTimeoutInMinutes

選擇性。指定 TCP 閒置連線的逾時。此值可介於 4 與 30 分鐘之間。預設值為 4 分鐘。此元素只限於通訊協定設定為 TCP 時才會使用。

必須使用 2014/6/1 版或更高版本,才能使用 IdleTimeoutInMinutes 元素。

包含定義端點設定的屬性,以供負載平衡器用於監視虛擬機器的可用性,然後再將流量轉送至端點。

 

元素名稱 說明

路徑

選擇性。指定要檢查以判斷虛擬機器可用性狀態的相對路徑。如果 Protocol 設定為 TCP,此值必須為 NULL。

範例:

路徑

探查將會使用 https://example.com/path 來執行探查。

Port

選擇性。指定要用來檢查虛擬機器可用性狀態的連接埠。

通訊協定

選擇性。指定要用來檢查虛擬機器可用性狀態的通訊協定。

可能的值為:

  • HTTP

  • TCP

IntervalInSeconds

選擇性。指定負載平衡器探查的間隔 (以秒為單位)。最小值是 5 秒。預設值是 15 秒。

TimeoutInSeconds

選擇性。指定負載平衡器探查的逾時 (以秒為單位)。最小值是 11 秒。預設值是 31 秒。

包含用以控制將網路流量送至端點的規則集合。

 

元素名稱 說明

規則

必要項。指定存取控制規則的集合。最多允許 50 項規則。

規則

必要項。指定存取控制規則的定義。

訂單

必要項。指定規則的優先順序。此值可介於 0 到 65535 之間。集合內每一項規則的順序編號都必須是唯一的。順序編號愈低,規則的優先順序愈高。

動作

必要項。指定應該允許或拒絕符合規則的流量。

可能的值為:

  • permit

  • deny

RemoteSubnet

必要項。指定規則的子網路。子網路必須採用 IPV4 無類別網域間路由選擇 (CIDR) 標記法,而且必須是有效的子網路。

例如:10.0.0.0/24。

說明

選擇性。指定規則的描述。描述的長度上限是 256 個字元。

包含除了虛擬機器的預設虛擬 IP 位址以外可使用的公用 IP 位址。

 

元素名稱 說明

PublicIP

必要項。指定可用來與虛擬機器通訊的額外公用 IP 位址。

名稱

必要項。指定公用 IP 位址的名稱。

IdleTimeoutInMinutes

選擇性。指定 TCP 閒置連線的逾時。此值可介於 4 與 30 分鐘之間。預設值為 4 分鐘。此元素只限於通訊協定設定為 TCP 時才會使用。

必須使用 2014/6/1 版或更高版本,才能使用 IdleTimeoutInMinutes 元素。

包含虛擬機器所屬子網路的清單。

 

元素名稱 說明

SubnetName

必要項。指定虛擬機器所屬子網路的名稱。

包含用以將資料磁碟加入至虛擬機器的參數。

 

元素名稱 說明

DataVirtualHardDisk

必要項。指定用來建立資料磁碟的屬性。

HostCaching

選擇性。為了發揮讀取/寫入效率,指定資料磁碟的快取行為。這個此屬性會影響磁碟的一致性。

可能的值為:

  • None

  • ReadOnly

  • ReadWrite

預設值是 None

DiskName

選擇性。如果將要加入的磁碟已在訂閱中註冊,這個元素即用於識別所加入的磁碟。若是由 Azure 建立新磁碟和相關聯的 VHD,則 Azure 將指派由部署名稱、角色名稱和識別碼組合而成的唯一名稱,不會使用這個元素。

磁碟的名稱只能包含英數字元、底線、句號或虛線。名稱長度不得超過 256 個字元。名稱不得以句號或虛線結尾。

Lun

選擇性。指定資料磁碟的邏輯單元編號 (LUN)。如果磁碟是第一個加入的磁碟,這個元素即為選擇性且將使用預設值 0。如果加入的磁碟不止一個,這個元素則為必要項。

您可以利用取得角色找出已使用的 LUN 編號。

有效的 LUN 值是 0 到 31。

LogicalDiskSizeInGB

選擇性。指定要連接至虛擬機器之空白磁碟的大小 (以 GB 為單位)。如果將要加入的磁碟已在訂閱中註冊,便會忽略這個元素。若加入的方式是由 Azure 建立磁碟和 VHD,這個元素將定義新磁碟的大小。

可加入至虛擬機器的磁碟數目受限於虛擬機器的大小。如需詳細資訊,請參閱 Azure 的虛擬機器和雲端服務大小

MediaLink

選擇性。如果將要加入的磁碟已在訂閱中註冊,或該磁碟的 VHD 已存在於 Blob 儲存體,便會忽略這個元素。若 Blob 儲存體中沒有此 VHD 檔案,這個元素將定義加入新磁碟時新建立的 VHD 所在位置。

範例:

http://example.blob.core.windows.net/disks/mydatadisk.vhd

SourceMediaLink

選擇性。如果將要加入的磁碟已在訂閱中註冊,或該磁碟的 VHD 不存在於 Blob 儲存體,便會忽略這個元素。若 Blob 儲存體中存在此 VHD 檔案,這個元素將定義 VHD 的路徑,以此做為來源註冊磁碟並將其連接至虛擬機器。

包含用以建立虛擬機器之作業系統磁碟的參數。

 

元素名稱 說明

HostCaching

選擇性。指定作業系統磁碟的快取模式。這項設定會影響磁碟的一致性和效能。

可能的值為:

  • ReadOnly

  • ReadWrite

預設值是 ReadWrite

note附註
變更此值會導致虛擬機器重新啟動。

DiskLabel

選擇性。指定磁碟的描述。

MediaLink

選擇性。指定當 SourceImageName 指定平台映像時,建立的 VHD 檔案所在位置。

範例:

http://contoso.blob.core.windows.net/disks/mydisk.vhd

SourceImageName

選擇性。指定要用來建立虛擬機器之映像的名稱。您可以指定使用者映像或平台映像。映像一定會與 VHD 相關聯,後者是以分頁 Blob 的形式儲存在 Azure 儲存體帳戶中的 .vhd 檔案。如果指定平台映像,便會建立相關聯的 VHD,而必須使用 MediaLink 元素指定此 VHD 在儲存體中的位置。

包含要安裝於虛擬機器上的資源擴充功能集合。資源擴充功能是在虛擬機器上安裝的軟體元件。若要安裝資源延伸模組,必須在虛擬機器上安裝 VM 代理程式。

 

元素名稱 說明

ResourceExtensionReference

必要項。指定應在虛擬機器上安裝之資源擴充功能的屬性。

ReferenceName

必要項。指定資源擴充功能的參考名稱。

發行者

必要項。指定建立資源擴充功能的發行者名稱。您可以使用「列出資源擴充功能」尋找資源擴充功能的發行者名稱。

名稱

必要項。指定資源擴充功能的名稱。您可以使用 列出資源擴充功能 尋找可用的資源擴充功能名稱。

版本

必要項。指定資源擴充功能的版本。您可以將此值設為 * 以使用最新的延伸模組版本。如果已加入或更新延伸模組,必須確定先將 ReplicationCompleted 的值設為 true 才能使用延伸模組版本。您可以使用 列出資源擴充功能版本 來判定複寫狀態,及延伸模組的可用版本。

ResourceExtensionParameterValues

選擇性。包含在安裝時傳遞至資源擴充功能的參數集合。

狀態

選擇性。指定資源擴充功能的狀態。

可能的值為:

  • enable

  • disable

  • uninstall

預設值是 enable。必須以 enable 狀態加入新的延伸模組。

必須使用 2014-04-01 版或更高版本,才能使用 uninstall 狀態。

Certificates

選擇性。包含安裝於虛擬機器上並由延伸模組使用的憑證集合。憑證必須先新增到雲端服務,才能包含在此要求中。如需詳細資訊,請參閱加入服務憑證

必須使用 2014/6/1 版或更高版本,才能使用 Certificates 元素。

ForceUpdate

選擇性。

布林值。若在尚未更新組態時想要將組態重新套用至延伸模組,請設為 “true”。

必須使用 01.10.14 版或更高版本,才能使用 ForceUpdate 元素。

包含在安裝時傳遞至資源擴充功能的參數集合。

 

元素名稱 說明

ResourceExtensionParameterValue

必要項。指定參數的金鑰、值和類型。

金鑰

必要項。指定參數的金鑰。

必要項。指定參數的 Base-64 編碼值。如果延伸模組的組態是在 XML 中格式化,則會使用公用或私人結構描述來驗證此值。使用的結構描述視 Type 的值而定。

如果延伸模組的組態是在 JSON 中格式化,則此值必須包含有效的 JSON 物件。公用或私人結構描述無法用於驗證物件。若要使用 JSON 物件,版本必須是 2014-04-01 或更新版本。

類型

必要項。指定資源擴充功能的類型。

可能的值為:

  • Public

  • Private

如果這個值設為 Private,則參數不會由取得部署傳回。

回應包括 HTTP 狀態碼、一組回應標頭和回應主體。

成功的作業會傳回狀態碼「202 (已接受)」。如需狀態碼的資訊,請參閱<服務管理狀態和錯誤碼>。

這項作業的回應包括下列標頭。回應也可能包括其他標準 HTTP 標頭。所有標準標頭都符合 HTTP/1.1 通訊協定規格

 

回應標頭 說明

x-ms-request-id

唯一識別對管理服務發出之要求的值。

無。

您也可以使用 Update-AzureVM Cmdlet 來變更虛擬機器的組態。

本文對您有任何幫助嗎?
(剩餘 1500 個字元)
感謝您提供意見
顯示:
© 2015 Microsoft