az cloud-service

Hinweis

Diese Referenz ist Teil der Clouddiensterweiterung für die Azure CLI (Version 2.15.0 oder höher). Die Erweiterung installiert automatisch beim ersten Ausführen eines Az-Clouddienstbefehls . Weitere Informationen zu Erweiterungen

Verwalten des Clouddiensts (erweiterter Support).

Befehle

az cloud-service create

Erstellen Eines Clouddiensts (erweiterter Support). Bitte beachten Sie, dass einige Eigenschaften nur während der Erstellung von Clouddiensts festgelegt werden können.

az cloud-service delete

Löschen eines Clouddiensts.

az cloud-service delete-instance

Löschen von Rolleninstanzen in einem Clouddienst.

az cloud-service list

Rufen Sie eine Liste aller Clouddienste unter einer Ressourcengruppe ab.

az cloud-service list-all

Rufen Sie eine Liste aller Clouddienste im Abonnement ab, unabhängig von der zugeordneten Ressourcengruppe.

az cloud-service power-off

Deaktivieren Sie den Clouddienst. Beachten Sie, dass Ressourcen weiterhin angefügt sind und Sie die Kosten für die Ressourcen erhalten.

az cloud-service rebuild

Rolleninstanzen neu erstellen. Installieren Sie das Betriebssystem auf Instanzen von Webrollen oder Workerrollen neu, und initialisieren Sie die von ihnen verwendeten Speicherressourcen. Wenn Sie speicherressourcen nicht initialisieren möchten, können Sie Reimage-Rolleninstanzen verwenden.

az cloud-service reimage

Neuimage asynchroner Vorgang installiert das Betriebssystem auf Instanzen von Webrollen oder Workerrollen neu.

az cloud-service restart

Starten Sie eine oder mehrere Rolleninstanzen in einem Clouddienst neu.

az cloud-service role

Verwalten der Clouddienstrolle mit Clouddienst

az cloud-service role list

Rufen Sie eine Liste aller Rollen in einem Clouddienst ab.

az cloud-service role show

Rufen Sie eine Rolle von einem Clouddienst ab.

az cloud-service role-instance

Verwalten der Rolleninstanz des Clouddiensts mit Clouddienst.

az cloud-service role-instance delete

Löschen einer Rolleninstanz aus einem Clouddienst

az cloud-service role-instance list

Rufen Sie die Liste aller Rolleninstanzen in einem Clouddienst ab.

az cloud-service role-instance rebuild

Der asynchrone Vorgang "Rolleninstanz neu erstellen" installiert das Betriebssystem auf Instanzen von Webrollen oder Arbeitsrollen und initialisiert die von ihnen verwendeten Speicherressourcen. Wenn Sie Speicherressourcen nicht initialisieren möchten, können Sie reimage Role Instance verwenden.

az cloud-service role-instance reimage

Der asynchrone Vorgang "Reimage Role Instance" installiert das Betriebssystem auf Instanzen von Webrollen oder Arbeitsrollen neu.

az cloud-service role-instance restart

Der asynchrone Neustart der Rolleninstanz fordert einen Neustart einer Rolleninstanz im Clouddienst an.

az cloud-service role-instance show

Abrufen einer Rolleninstanz aus einem Clouddienst.

az cloud-service role-instance show-instance-view

Rufen Sie Informationen zum Laufzeitstatus einer Rolleninstanz in einem Clouddienst ab.

az cloud-service role-instance show-remote-desktop-file

Rufen Sie eine Remotedesktopdatei für eine Rolleninstanz in einem Clouddienst ab.

az cloud-service show

Anzeigen von Informationen zu einem Clouddienst.

az cloud-service show-instance-view

Rufen Sie den Status eines Clouddiensts ab.

az cloud-service start

Starten Sie den Clouddienst.

az cloud-service update

Aktualisieren eines Clouddiensts.

az cloud-service update-domain

Verwalten der Clouddienstaktualisierungsdomäne mit Clouddienst.

az cloud-service update-domain list-update-domain

Rufen Sie eine Liste aller Updatedomänen in einem Clouddienst ab.

az cloud-service update-domain show-update-domain

Rufen Sie die angegebene Updatedomäne eines Clouddiensts ab.

az cloud-service update-domain walk-update-domain

Aktualisieren Sie die Rolleninstanzen in der angegebenen Updatedomäne.

az cloud-service wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung des Clouddiensts erfüllt ist.

az cloud-service create

Erstellen Eines Clouddiensts (erweiterter Support). Bitte beachten Sie, dass einige Eigenschaften nur während der Erstellung von Clouddiensts festgelegt werden können.

az cloud-service create --cloud-service-name
                        --resource-group
                        [--configuration]
                        [--configuration-url]
                        [--extensions]
                        [--id]
                        [--lb]
                        [--location]
                        [--no-wait]
                        [--package-url]
                        [--roles]
                        [--secrets]
                        [--start-cloud-service {false, true}]
                        [--tags]
                        [--upgrade-mode {Auto, Manual, Simultaneous}]

Beispiele

Erstellen Sie einen Clouddienst mit 2 Rollen, 2 Lastenausgleichsmodulen (eine verfügt über eine öffentliche IP und eine andere über eine private IP), Geheime und Erweiterungen.

az cloud-service create -g ResourceGroup -n CloudService --roles ContosoFrontend:Standard_D1_v2:1:Standard ContosoBackend:Standard_D1_v2:1:Standard --package-url PackageURL --configuration Config --load-balancer-configurations MyLoadBalancer:MyFe:PublicIP:: MyLoadBalancer2:MyFe2::SubnetIDd:PrivateIPID --secrets Vault0:Cert0:Cert1 Vault1:Cert2:Cert3:Cert4 --extensions "@extensions.json"

Erforderliche Parameter

--cloud-service-name --name -n

Der Name des Clouddiensts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--configuration

Geben Sie die XML-Dienstkonfiguration (Cscfg) für den Clouddienst an. Erwarteter Wert: xml-string/@xml-file.

--configuration-url

Geben Sie eine URL an, die auf den Speicherort der Dienstkonfiguration im Blob-Dienst verweist. Die Dienstpaket-URL kann der SAS-URI (Shared Access Signature) aus jedem Speicherkonto sein. Dies ist eine schreibgeschützte Eigenschaft und wird in GET-Aufrufen nicht zurückgegeben.

--extensions

Liste der Erweiterungen für den Clouddienst. Erwarteter Wert: json-string/@json-file. Beispiel: [{"properties": {"type": "RDP", "autoUpgradeMinorVersion": false, "protectedSettings": "settings",publisher": "Microsoft.Windows.Azure.Extensions", "settings": "settings", "typeHandlerVersion": "1.2.1"}, "name": "RDPExtension"}].

--id

Ressourcen-ID.

--lb --load-balancer-configurations

Die Liste der Lastenausgleichskonfigurationen, die durch Speicherplatz für den Clouddienst getrennt sind. Die öffentliche IP ist ein obligatorisches Feld. Format: LBName:FrontendIPConfiguration:PublicIPAddress:Subnet:PrivateIP.

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--package-url

Geben Sie eine URL an, die auf den Speicherort des Dienstpakets im Blob-Dienst verweist. Die Dienstpaket-URL kann der SAS-URI (Shared Access Signature) aus jedem Speicherkonto sein. Dies ist eine schreibgeschützte Eigenschaft und wird in GET-Aufrufen nicht zurückgegeben.

--roles

Liste der Rollen, die durch Leerzeichen für den Clouddienst getrennt sind. Format: RoleName:SkuName:SkuCapacity:SkuTier.

--secrets

Geben Sie Zertifikate an, die durch Leerzeichen getrennt sind, die auf den Rolleninstanzen installiert werden sollen. Format: KeyVaultName:CertificateUrl:CertificateUrl2:...:CertificateUrlN.

--start-cloud-service

Geben Sie an, ob der Clouddienst unmittelbar nach der Erstellung gestartet werden soll. Standardwert: true. Wenn "false", wird das Dienstmodell weiterhin bereitgestellt, der Code wird jedoch nicht sofort ausgeführt. Stattdessen wird der Dienst unterstützt, bis Sie "Start" aufrufen, zu dem Zeitpunkt, zu dem der Dienst gestartet wird. Ein bereitgestellter Dienst verursacht weiterhin Gebühren, auch wenn er ausgeschaltet wird.

Zulässige Werte: false, true
--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--upgrade-mode

Updatemodus für den Clouddienst. Rolleninstanzen werden den Aktualisierungsdomänen zugeordnet, wenn der Dienst bereitgestellt wird. Updates können in jeder Aktualisierungsdomäne manuell initiiert oder in allen Updatedomänen automatisch initiiert werden. Mögliche Werte sind automatisch, manuell, gleichzeitig. Wenn nicht angegeben, ist der Standardwert auto. Wenn sie auf "Manuell" festgelegt ist, muss PUT UpdateDomain aufgerufen werden, um das Update anzuwenden. Wenn sie auf "Automatisch" festgelegt ist, wird das Update automatisch auf jede Updatedomäne angewendet.

Zulässige Werte: Auto, Manual, Simultaneous

az cloud-service delete

Löschen eines Clouddiensts.

az cloud-service delete --cloud-service-name
                        --resource-group
                        [--no-wait]
                        [--yes]

Erforderliche Parameter

--cloud-service-name --name -n

Der Name des Clouddiensts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--yes -y

Nicht zur Bestätigung auffordern

az cloud-service delete-instance

Löschen von Rolleninstanzen in einem Clouddienst.

az cloud-service delete-instance --cloud-service-name
                                 --resource-group
                                 [--no-wait]
                                 [--role-instances]
                                 [--yes]

Erforderliche Parameter

--cloud-service-name --name -n

Der Name des Clouddiensts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--role-instances

Liste der Namen der Rolleninstanzen des Clouddiensts. Der Wert von "*" bedeutet alle Rolleninstanzen des Clouddiensts.

--yes -y

Nicht zur Bestätigung auffordern

az cloud-service list

Rufen Sie eine Liste aller Clouddienste unter einer Ressourcengruppe ab.

az cloud-service list --resource-group

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az cloud-service list-all

Rufen Sie eine Liste aller Clouddienste im Abonnement ab, unabhängig von der zugeordneten Ressourcengruppe.

az cloud-service list-all

az cloud-service power-off

Deaktivieren Sie den Clouddienst. Beachten Sie, dass Ressourcen weiterhin angefügt sind und Sie die Kosten für die Ressourcen erhalten.

az cloud-service power-off --cloud-service-name
                           --resource-group
                           [--no-wait]

Erforderliche Parameter

--cloud-service-name --name -n

Der Name des Clouddiensts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

az cloud-service rebuild

Rolleninstanzen neu erstellen. Installieren Sie das Betriebssystem auf Instanzen von Webrollen oder Workerrollen neu, und initialisieren Sie die von ihnen verwendeten Speicherressourcen. Wenn Sie speicherressourcen nicht initialisieren möchten, können Sie Reimage-Rolleninstanzen verwenden.

az cloud-service rebuild --cloud-service-name
                         --resource-group
                         [--no-wait]
                         [--role-instances]

Erforderliche Parameter

--cloud-service-name --name -n

Der Name des Clouddiensts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--role-instances

Liste der Namen der Rolleninstanzen des Clouddiensts. Der Wert von "*" bedeutet alle Rolleninstanzen des Clouddiensts.

az cloud-service reimage

Neuimage asynchroner Vorgang installiert das Betriebssystem auf Instanzen von Webrollen oder Workerrollen neu.

az cloud-service reimage --cloud-service-name
                         --resource-group
                         [--no-wait]
                         [--role-instances]

Erforderliche Parameter

--cloud-service-name --name -n

Der Name des Clouddiensts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--role-instances

Liste der Namen der Rolleninstanzen des Clouddiensts. Der Wert von "*" bedeutet alle Rolleninstanzen des Clouddiensts.

az cloud-service restart

Starten Sie eine oder mehrere Rolleninstanzen in einem Clouddienst neu.

az cloud-service restart --cloud-service-name
                         --resource-group
                         [--no-wait]
                         [--role-instances]

Erforderliche Parameter

--cloud-service-name --name -n

Der Name des Clouddiensts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--role-instances

Liste der Namen der Rolleninstanzen des Clouddiensts. Der Wert von "*" bedeutet alle Rolleninstanzen des Clouddiensts.

az cloud-service show

Anzeigen von Informationen zu einem Clouddienst.

az cloud-service show --cloud-service-name
                      --resource-group

Erforderliche Parameter

--cloud-service-name --name -n

Der Name des Clouddiensts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az cloud-service show-instance-view

Rufen Sie den Status eines Clouddiensts ab.

az cloud-service show-instance-view --cloud-service-name
                                    --resource-group

Erforderliche Parameter

--cloud-service-name --name -n

Der Name des Clouddiensts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az cloud-service start

Starten Sie den Clouddienst.

az cloud-service start --cloud-service-name
                       --resource-group
                       [--no-wait]

Erforderliche Parameter

--cloud-service-name --name -n

Der Name des Clouddiensts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

az cloud-service update

Aktualisieren eines Clouddiensts.

az cloud-service update --cloud-service-name
                        --resource-group
                        [--no-wait]
                        [--tags]

Erforderliche Parameter

--cloud-service-name --name -n

Der Name des Clouddiensts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

az cloud-service wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung des Clouddiensts erfüllt ist.

az cloud-service wait --cloud-service-name
                      --resource-group
                      [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--interval]
                      [--timeout]
                      [--updated]

Erforderliche Parameter

--cloud-service-name --name -n

Der Name des Clouddiensts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--created

Warten Sie, bis Sie mit "provisioningState" unter "Erfolgreich" erstellt wurden.

--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

--exists

Warten Sie, bis die Ressource vorhanden ist.

--interval

Abfrageintervall in Sekunden.

Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis die Aktualisierung mit provisioningState unter "Erfolgreich" ausgeführt wurde.