(0) exportieren Drucken
Alle erweitern

Update-Rolle

Letzte Aktualisierung: Mai 2014

Der Vorgang Update Role aktualisiert die Konfiguration des angegebenen virtuellen Computers.

Die Update Role-Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id> durch die Abonnement-ID, <cloudservice-name> durch den Namen des Cloud-Diensts, <deployment-name> durch den Namen der Bereitstellung und <role-name> durch den Namen des virtuellen Computers.

 

Methode Anforderungs-URI

PUT

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

Sie müssen sicherstellen, dass die an den Verwaltungsdienst gestellte Anforderung sicher ist. Zusätzliche Informationen finden Sie im Thema Authenticating Service Management Requests.

In der folgenden Tabelle werden die Anforderungsheader beschrieben.

 

Anforderungsheader Beschreibung

x-ms-version

Erforderlich. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Dieser Header sollte auf 01.03.2012 oder höher festgelegt werden. Weitere Informationen zur Versionsverwaltung von Headern finden Sie unter Dienstverwaltungs-Versionsverwaltung.

Der Anforderungstext weist das folgende Format auf:

    
<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>
          <LoadBalancerName>name-of-internal-loadbalancer</LoadBalancerName>
          <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>
        </InputEndpoint>
      </InputEndpoints>
      <SubnetNames>
        <SubnetName>name-of-subnet</SubnetName>
      </SubnetNames>
      <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress>
      <PublicIPs>
        <PublicIP>
          <Name>name-of-public-ip</Name>
        <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>
    </ResourceExtensionReference>
  </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>

In der folgenden Tabelle werden die Elemente des Anforderungstexts beschrieben.

 

Elementname Beschreibung

ConfigurationSets

Optional. Enthält eine Auflistung von Konfigurationssätzen, durch die System- und Anwendungseinstellungen definiert werden.

ResourceExtensionReferences

Optional. Enthält eine Auflistung von Ressourcenerweiterungen, die auf dem virtuellen Computer installiert werden sollen. Dieses Element wird verwendet, wenn ProvisionGuestAgent auf true festgelegt ist.

Das ResourceExtensionReferences-Element ist nur bei Version 01.11.2013 und höher verfügbar.

AvailabilitySetName

Optional. Gibt den Namen einer Auflistung virtueller Computer an. Die virtuellen Computer, die in derselben Verfügbarkeitsgruppe angegeben werden, sind verschiedenen Knoten zugeordnet, um die Verfügbarkeit zu maximieren. Weitere Informationen zu Verfügbarkeitsgruppen finden Sie unter Verwalten der Verfügbarkeit virtueller Computer.

DataVirtualHardDisks

Optional. Enthält die Parameter, mit denen einem virtuellen Computer ein Datenträger hinzugefügt wird. Weitere Informationen zu Datenträgern finden Sie unter Datenträger und Images verwalten.

OSVirtualHardDisk

Erforderlich. Enthält die Parameter, mit denen der Betriebssystem-Datenträger für einen virtuellen Computer erstellt wird.

RoleSize

Optional. Gibt die Größe des virtuellen Computers an. Die Standardgröße ist Small. Weitere Informationen zu Kapazitäten virtueller Computer finden Sie unter Kapazitäten für virtuelle Computer und Cloud-Dienste unter Azure.

ProvisionGuestAgent

Optional. Zeigt an, ob der VM-Agent auf dem virtuellen Computer installiert ist. Um eine Ressourcenerweiterung auf einem virtuellen Computer auszuführen, muss dieser Agent installiert sein.

Folgende Werte sind möglich:

  • true

  • false

Wenn der VM-Agent bereits auf dem virtuellen Computer installiert wurde, kann der Wert nicht false sein.

Enthält eine Auflistung von Konfigurationssätzen, durch die System- und Anwendungseinstellungen definiert werden.

 

Elementname Beschreibung

ConfigurationSetType

Erforderlich. Sie können nur Einstellungen im NetworkConfiguration-Satz aktualisieren.

InputEndpoints

Optional. Enthält eine Auflistung externer Endpunkte für den virtuellen Computer.

SubnetNames

Erforderlich, wenn StaticVirtualNetworkIPAddress angegeben wird; andernfalls in NetworkConfiguration optional. Enthält eine Liste von Subnetzen, denen der virtuelle Computer angehört.

StaticVirtualNetworkIPAddress

Optional. Gibt die interne IP-Adresse für den virtuellen Computer in einem virtuellen Netzwerk an. Wenn Sie dieses Element angeben, müssen Sie ebenfalls das SubnetNames-Element mit nur einem definierten Subnetz angeben. Die IP-Adresse, die in diesem Element angegeben wird, muss dem Subnetz angehören, das in SubnetNames definiert ist, und sollte weder den ersten vier IP-Adressen noch der letzten IP-Adresse im Subnetz entsprechen.

Das StaticVirtualNetworkIPAddress-Element ist nur bei Version 01.11.2013 und höher verfügbar.

PublicIPs

Optional. Enthält eine öffentliche IP-Adresse, die zusätzlich zur virtuellen IP-Standardadresse für den virtuellen Computer verwendet werden kann.

Das PublicIPs-Element ist nur bei Version 01.05.2014 und höher verfügbar.

Enthält eine Auflistung externer Endpunkte für den virtuellen Computer.

 

Elementname Beschreibung

InputEndpoint

Erforderlich. Gibt die Eigenschaften an, durch die ein externer Endpunkt für den virtuellen Computer definiert wird.

LoadBalancedEndpointSetName

Optional. Gibt einen Namen für einen Satz von Endpunkten mit Lastenausgleich an. Wenn dieses Element für einen Endpunkt angeben wird, wird er dem Satz hinzugefügt.

Diese Eigenschaft sollte nicht festgelegt werden, wenn Sie den Endpunkt hinzufügen, um über den Remotedesktop eine Verbindung mit dem virtuellen Computer herzustellen.

noteHinweis
Der Endpunktname muss im Bereich des virtuellen Computers eindeutig sein.

LocalPort

Erforderlich. Gibt den internen Port an, an dem der virtuelle Computer lauscht.

Name

Erforderlich. Gibt den Namen des externen Endpunkts an.

Port

Erforderlich. Gibt den für den Endpunkt zu verwendenden externen Port an.

LoadBalancerProbe

Optional. Enthält Eigenschaften, die die Endpunkteinstellungen definieren, die der Lastenausgleich zur Überwachung der Verfügbarkeit des virtuellen Computers verwendet, bevor Datenverkehr an ihn weitergeleitet wird.

LoadBalancerName

Optional. Gibt den Namen des internen Lastenausgleichs an, der diesem Endpunkt zugeordnet ist. Der Name des internen Lastenausgleichs wird in LoadBalancers angegeben.

Das LoadBalancerName-Element ist nur bei Version 01.05.2014 und höher verfügbar.

Protokoll

Erforderlich. Gibt das Transportprotokoll für den Endpunkt an.

Folgende Werte sind möglich:

  • TCP

  • UDP

Der Standardwert lautet false.

EnableDirectServerReturn

Optional. Gibt an, ob der Endpunkt Direct Server Return verwendet. Das EnableDirectServerReturn-Element wird bei RDP-, SSH- oder WinRM-Endpunkten und auch dann nicht unterstützt, wenn der öffentliche Port und der lokale Port eines Endpunkts voneinander abweichen. EnableDirectServerReturn kann für ein Endpunkt nicht deaktiviert werden. Wenn EnableDirectServerReturn auf true festgelegt ist, kann der Wert von Protocol nicht aktualisiert werden. Es wird empfohlen, dieses Element nur zu verwenden, wenn Sie virtuelle Computer für SQL Server und AlwaysOn-Verfügbarkeitsgruppen einrichten. Weitere Informationen finden Sie unter Hochverfügbarkeit und Notfallwiederherstellung für SQL Server auf Azure-Virtuellen Computern.

Folgende Werte sind möglich:

  • true

  • false

Der Standardwert lautet false.

EndpointAcl

Optional. Enthält eine Auflistung mit Regeln, die den Netzwerkdatenverkehr zum Endpunkt steuern.

Das EndpointAcl-Element ist nur bei Verwendung von Version 01.06.2013 oder höher verfügbar.

Enthält Eigenschaften, die die Endpunkteinstellungen definieren, die der Lastenausgleich zur Überwachung der Verfügbarkeit des virtuellen Computers verwendet, bevor Datenverkehr an ihn weitergeleitet wird.

 

Elementname Beschreibung

Pfad

Optional. Gibt den relativen Pfad an, der überprüft werden muss, um den Verfügbarkeitsstatus des virtuellen Computers zu bestimmen. Wenn Protocol auf TCP festgelegt ist, muss dieser Wert NULL sein.

Beispiel:

Pfad

Zur Durchführung der Überprüfung wird https://example.com/path verwendet.

Port

Optional. Gibt den Port an, der zur Überprüfung des Verfügbarkeitsstatus des virtuellen Computers verwendet wird.

Protokoll

Optional. Gibt das Protokoll an, das zur Überprüfung des Verfügbarkeitsstatus des virtuellen Computers verwendet wird.

Folgende Werte sind möglich:

  • HTTP

  • TCP

IntervalInSeconds

Optional. Gibt das Intervall für die Lastenausgleichsüberprüfung in Sekunden an. Der Wert muss mindestens 5 Sekunden betragen. Der Standardwert ist 15 Sekunden.

TimeoutInSeconds

Optional. Gibt das Timeout für die Lastenausgleichsüberprüfung in Sekunden an. Der Wert muss mindestens 11 Sekunden betragen. Der Standardwert ist 31 Sekunden.

Enthält eine Auflistung mit Regeln, die den Netzwerkdatenverkehr zum Endpunkt steuern.

 

Elementname Beschreibung

Regeln

Erforderlich. Gibt eine Auflistung mit Zugriffssteuerungsregeln an. Es sind maximal 50 Regeln zulässig.

Rule

Erforderlich. Gibt die Definition einer Zugriffssteuerungsregel an.

Order

Erforderlich. Gibt die Priorität der Regel an. Der Wert kann zwischen 0 und 65.535 liegen. Die Ordnungszahl muss für jede Regel in der Sammlung eindeutig sein. Je niedriger die Ordnungszahl, umso höher ist die Priorität der Regel.

Aktion

Erforderlich. Gibt an, ob Datenverkehr, der die Regel erfüllt, zugelassen oder verweigert wird.

Folgende Werte sind möglich:

  • permit

  • deny

RemoteSubnet

Erforderlich. Gibt das Subnetz für die Regel an. Das Subnetz muss in der IPV4 CIDR (Classless Inter-Domain Routing)-Schreibweise angegeben und gültig sein.

Beispiel: 10.0.0.0/24

Beschreibung

Optional. Gibt eine Beschreibung für die Regel an. Die maximale Länge der Beschreibung beträgt 256 Zeichen.

Enthält eine öffentliche IP-Adresse, die zusätzlich zur virtuellen IP-Standardadresse für den virtuellen Computer verwendet werden kann.

 

Elementname Beschreibung

PublicIP

Erforderlich. Gibt eine zusätzliche öffentliche IP-Adresse an, die zur Kommunikation mit dem virtuellen Computer verwendet werden kann.

Name

Erforderlich. Gibt den Namen der öffentlichen IP-Adresse an.

Enthält eine Liste von Subnetzen, denen der virtuelle Computer angehört.

 

Elementname Beschreibung

SubnetName

Erforderlich. Gibt den Namen eines Subnetzes an, dem der virtuelle Computer angehört.

Enthält die Parameter, mit denen einem virtuellen Computer ein Datenträger hinzugefügt wird.

 

Elementname Beschreibung

DataVirtualHardDisk

Erforderlich. Gibt die Eigenschaften an, die verwendet werden, um einen Datenträger zu erstellen.

HostCaching

Optional. Gibt das Cachingverhalten des Datenträgers für Lese-/Schreibeffizienz an. Das Festlegen dieser Eigenschaft wirkt sich auf die Konsistenz des Datenträgers aus.

Folgende Werte sind möglich:

  • None

  • ReadOnly

  • ReadWrite

Der Standardwert lautet None.

DiskName

Optional. Wenn der hinzugefügte Datenträger bereits im Abonnement registriert ist, wird mit diesem Element der hinzuzufügende Datenträger identifiziert. Wenn ein neuer Datenträger und die zugeordnete VHD von Azure erstellt werden, wird dieses Element nicht verwendet. Stattdessen weist Azure einen eindeutigen Namen zu, der eine Kombination aus Bereitstellungsname, Rollenname und Kennnummer darstellt.

Der Name des Datenträgers darf nur alphanumerische Zeichen, Unterstriche, Punkte oder Gedankenstriche enthalten. Der Name darf nicht länger als 256 Zeichen sein. Der Name darf nicht mit einem Punkt oder Gedankenstrich enden.

Lun

Optional. Gibt die Nummer der logischen Einheit (LUN) für den Datenträger an. Wenn der Datenträger als erster Datenträger hinzugefügt wurde, ist dieses Element optional und verfügt über den Standardwert 0. Falls mehrere Datenträger hinzugefügt werden, ist dieses Element erforderlich.

Mithilfe von Rolle abrufen können Sie die bereits verwendeten LUNs ermitteln.

Gültige LUN-Werte sind 0 bis 15.

LogicalDiskSizeInGB

Optional. Gibt die Größe eines an den virtuellen Computer anzufügenden, leeren Datenträgers in GB an. Wenn der hinzugefügte Datenträger bereits im Abonnement registriert ist, wird dieses Element ignoriert. Wenn der Datenträger und die VHD während des Hinzufügens von Azure erstellt werden, definiert dieses Element die Größe des neuen Datenträgers.

Die Anzahl der Datenträger, die einem virtuellen Computer hinzugefügt werden können, ist auf die Größe des Computers beschränkt. Weitere Informationen finden Sie unter Kapazitäten für virtuelle Computer und Cloud-Dienste unter Azure.

MediaLink

Optional. Wenn der hinzugefügte Datenträger bereits im Abonnement registriert oder die VHD für den Datenträger bereits im BLOB-Speicher enthalten ist, wird dieses Element ignoriert. Wenn keine VHD-Datei im BLOB-Speicher enthalten ist, definiert dieses Element, wo sich die neue VHD, die beim Hinzufügen des neuen Datenträgers erstellt wird, befindet.

Beispiel:

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

SourceMediaLink

Optional. Wenn der hinzugefügte Datenträger bereits im Abonnement registriert oder die VHD für den Datenträger nicht im BLOB-Speicher enthalten ist, wird dieses Element ignoriert. Wenn die VHD-Datei im BLOB-Speicher enthalten ist, definiert dieses Element den Pfad zur VHD. Außerdem wird daraus ein Datenträger registriert und an den virtuellen Computer angefügt.

Enthält die Parameter, mit denen der Betriebssystem-Datenträger für einen virtuellen Computer erstellt wird.

 

Elementname Beschreibung

HostCaching

Optional. Gibt den Cachingmodus des Betriebssystem-Datenträgers an. Diese Einstellung wirkt sich auf die Konsistenz und Leistung des Datenträgers aus.

Folgende Werte sind möglich:

  • ReadOnly

  • ReadWrite

Der Standardwert lautet ReadWrite.

noteHinweis
Durch Ändern dieses Werts wird der virtuelle Computer neu gestartet.

DiskLabel

Optional. Gibt die Beschreibung des Datenträgers an.

MediaLink

Optional. Gibt den Speicherort der VHD-Datei an, die erstellt wird, wenn durch SourceImageName ein Plattformimage angegeben wird.

Beispiel:

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

SourceImageName

Optional. Gibt den Namen des Images an, das zum Erstellen des virtuellen Computers verwendet werden soll. Sie können ein Benutzerimage oder Plattformimage angeben. Ein Image ist immer einer VHD zugeordnet, die einer als Seiten-BLOB unter einem Speicherkonto in Azure gespeicherten VHD-Datei entspricht. Bei Angabe eines Plattformimages wird eine zugeordnete VHD erstellt, und Sie müssen das MediaLink-Element verwenden, um anzugeben, wo sich die VHD im Speicher befindet.

Enthält eine Auflistung von Ressourcenerweiterungen, die auf dem virtuellen Computer installiert werden sollen. Eine Ressourcenerweiterung ist eine Softwarekomponente, die auf dem virtuellen Computer installiert ist. Der VM-Agent muss auf dem virtuellen Computer installiert sein, um Ressourcenerweiterungen zu installieren.

 

Elementname Beschreibung

ResourceExtensionReference

Erforderlich. Gibt die Eigenschaften einer Ressourcenerweiterung an, die auf dem virtuellen Computer installiert werden soll.

ReferenceName

Erforderlich. Gibt den Verweisnamen der Ressourcenerweiterung an.

Verleger

Erforderlich. Gibt den Namen des Verlegers an, der die Ressourcenerweiterung erstellt hat. Um den Verlegernamen einer Ressourcenerweiterung zu suchen, können Sie Ressourcenerweiterungen auflisten verwenden.

Name

Erforderlich. Gibt den Namen der Ressourcenerweiterung an. Sie können Ressourcenerweiterungen auflisten verwenden, um die Namen der verfügbaren Ressourcenerweiterungen zu suchen.

Version

Erforderlich. Gibt die Version der Ressourcenerweiterung an. Sie können diesen Wert auf * festlegen, um die neuste Version der Erweiterung zu verwenden. Wenn die Erweiterung zuletzt hinzugefügt oder aktualisiert wurde, müssen Sie sicherstellen, dass der Wert von ReplicationCompleted auf true festgelegt ist, bevor Sie die Version der Erweiterung verwenden können. Sie können Versionen von Ressourcenerweiterungen auflisten verwenden, um den Replikationsstatus und die verfügbaren Versionen der Erweiterung zu bestimmen.

ResourceExtensionParameterValues

Optional. Enthält eine Auflistung von Parametern, die bei der Installation an die Ressourcenerweiterung übergeben werden.

Status

Optional. Gibt den Status der Ressourcenerweiterung an.

Folgende Werte sind möglich:

  • enable

  • disable

  • uninstall

Der Standardwert lautet enable. Eine neue Erweiterung muss mit dem Zustand enable hinzugefügt werden.

Der Zustand uninstall ist nur bei Verwendung von Version 01.04.2014 oder höher verfügbar.

Enthält eine Auflistung von Parametern, die bei der Installation an die Ressourcenerweiterung übergeben werden.

 

Elementname Beschreibung

ResourceExtensionParameterValue

Erforderlich. Gibt den Schlüssel, Wert und Typ des Parameters an.

Key

Erforderlich. Gibt den Schlüssel des Parameters an.

Wert

Erforderlich. Gibt den Base-64-codierten Wert des Parameters an. Wenn die Konfiguration der Erweiterung in XML formatiert ist, wird dieser Wert unter Verwendung des öffentlichen oder privaten Schemas überprüft. Das verwendete Schema hängt vom Wert von Type ab.

Wenn die Konfiguration der Erweiterung in JSON formatiert ist, muss dieser Wert ein gültige JSON-Objekt enthalten. Das öffentliche oder private Schema kann nicht zur Überprüfung dieses Objekts verwendet werden. Um ein JSON-Objekt zu verwenden, muss die Version 2014-04-01 oder höher sein.

Typ

Erforderlich. Gibt den Typ für die Ressourcenerweiterung an.

Folgende Werte sind möglich:

  • Public

  • Private

Wenn dieser Wert auf Private festgelegt ist, wird der Parameter nicht durch Bereitstellung abrufen zurückgegeben.

Die Antwort enthält den HTTP-Statuscode, einen Satz von Antwortheadern und einen Antworttext.

Ein erfolgreicher Vorgang gibt den Statuscode 202 (Akzeptiert) zurück. Weitere Informationen zu Statuscodes finden Sie unter Service Management Status and Error Codes.

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

 

Antwortheader Beschreibung

x-ms-request-id

Ein Wert, der eine für den Verwaltungsdienst ausgeführte Anforderung eindeutig identifiziert.

Keine.

Sie können auch das Update-AzureVM-Cmdlet verwenden, um die Konfiguration eines virtuellen Computers zu ändern.

Anzeigen:
© 2014 Microsoft