更新角色
本文章是由機器翻譯。 將指標移到文章內的文字上方即可查看原文。
譯文
原文

更新角色

 

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年-03-01 或更高版本。 如需有關版本設定標頭的詳細資訊,請參閱 服務管理版本控制

要求主體的格式如下:


<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> <DomainNameLabel>domain-name</DomainNameLabel> <PublicIP> <PublicIPs> <NetworkInterfaces> <NetworkInterface> <Name>interface-name</Name> <IPConfigurations> <IPConfiguration> <SubnetName>subnet-name</SubnetName> <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress> </IPConfiguration> </IPConfigurations> </NetworkInterface> <NetworkInterfaces> <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

ResourceExtensionReferences 項目只是使用 2013年-11-01 版或更高版本。

AvailabilitySetName

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

DataVirtualHardDisks

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

OSVirtualHardDisk

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

RoleSize

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

ProvisionGuestAgent

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

可能的值為:

  • true

  • false

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

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

元素名稱

說明

ConfigurationSetType

必要項。 您只能更新中的設定 NetworkConfiguration 設定。

InputEndpoints

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

SubnetNames

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

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

如果這個項目搭配 StaticVirtualNetworkIPAddress 項目,然後更新不允許這個參數。

StaticVirtualNetworkIPAddress

選擇項。 為虛擬網路中的虛擬機器指定內部 IP 位址。 如果您指定這個項目,您也必須指定 SubnetNames 只能有一個子網路定義的項目。 此項目中指定的 IP 位址必須屬於中定義的子網路 SubnetNames 且不得前四個 IP 位址或子網路中的最後一個 IP 位址。

StaticVirtualNetworkIPAddress 項目只是使用 2013年-11-01 版或更高版本。

NetworkSecurityGroup

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

NetworkSecurityGroup 項目只是使用 2014年-10-01 版或更高版本。

PublicIPs

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

PublicIPs 項目只是使用 2014年-05-01 版或更高版本。

NetworkInterfaces

選擇性,一組次要網路介面。 允許的次要網路介面數目,取決於虛擬機器的大小。

必須使用 01.08.14 版或更高版本,才能使用 NetworkInterfaces 元素。

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

元素名稱

說明

InputEndpoint

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

LoadBalancedEndpointSetName

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

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

System_CAPS_note注意事項

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

LocalPort

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

名稱

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

Port

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

LoadBalancerProbe

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

通訊協定

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

可能的值為:

  • TCP

  • UDP

預設值是 false

EnableDirectServerReturn

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

可能的值為:

  • true

  • false

預設值是 false

EndpointACL

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

EndpointAcl 項目只是使用 2013年-06-01 版或更高版本。

LoadBalancerName

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

LoadBalancerName 項目只是使用 2014年-05-01 版或更高版本。

IdleTimeoutInMinutes

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

IdleTimeoutInMinutes 項目只是使用 2014年-06-01 版或更高版本。

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

元素名稱

說明

路徑

選擇項。 指定要檢查以判斷虛擬機器可用性狀態的相對路徑。 如果 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 時才會使用。

IdleTimeoutInMinutes 項目只是使用 2014年-06-01 版或更高版本。

DomainNameLabel

選擇項。 指定公用 IP 的網域名稱標籤。

DomainNameLabel 項目只是使用 2015年-03-01 版或更高版本。

包含一組次要網路介面。

元素名稱

說明

NetworkInterface

必要項。 指定次要網路介面。

名稱

必要項,會指定次要網路介面的名稱。

IPConfigurations

必要項。 指定次要網路介面的一組 IP 位址組態。

指定次要網路介面的一組 IP 位址組態。

元素名稱

說明

IPConfiguration

必要項。 指定次要網路介面的 IP 位址組態。

目前次要網路介面僅支援一個 IP 位址組態。

SubnetName

必要項。 指定此 IP 位址組態所屬之虛擬網路子網路的名稱。

位址

必要項,指定為次要網路介面設定的內部 IP 位址。

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

元素名稱

說明

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

System_CAPS_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 狀態。

uninstall 狀態只是使用 2014年-04-01 版或更高版本。

6103711b-8cf4-4317-9468-01b747bc87a8#bk_certificates

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

Certificates 項目只是使用 2014年-06-01 版或更高版本。

ForceUpdate

選擇項。

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

ForceUpdate 項目只是使用 2014年-10-01 版或更高版本。

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

元素名稱

說明

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 來變更虛擬機器的設定。

顯示:
© 2016 Microsoft