銷售: 1-800-867-1380

更新角色

更新日期: 2015年3月

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 時才會使用此元素。

必須使用 2013/11/1 版或更高版本,才能使用 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 位址。

必須使用 2013/11/1 版或更高版本,才能使用 StaticVirtualNetworkIPAddress 元素。

NetworkSecurityGroup

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

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

PublicIPs

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

必須使用 2014/5/1 版或更高版本,才能使用 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 中指定。

必須使用 2014/5/1 版或更高版本,才能使用 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”。

必須使用 2014/10/1 版或更高版本,才能使用 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