Freigeben über

az cdn custom-domain

  • Referenz

Verwalten Sie benutzerdefinierte Azure CDN-Domänen, um benutzerdefinierte Hostnamen für Endpunkte bereitzustellen.

Befehle

Name Beschreibung Typ Status
az cdn custom-domain create

Erstellen Sie eine neue benutzerdefinierte Domäne innerhalb eines Endpunkts.

 Kern GA
az cdn custom-domain delete

Löschen Einer vorhandenen benutzerdefinierten Domäne innerhalb eines Endpunkts.

 Kern GA
az cdn custom-domain disable-https

Deaktivieren Sie die HTTPS-Übermittlung der benutzerdefinierten Domäne.

 Kern GA
az cdn custom-domain enable-https

Aktivieren Sie HTTPS für eine benutzerdefinierte Domäne. Der Ressourcenname der benutzerdefinierten Domäne kann mit "az cdn custom-domain list" abgerufen werden.

 Kern GA
az cdn custom-domain list

Listet alle vorhandenen benutzerdefinierten Domänen innerhalb eines Endpunkts auf.

 Kern GA
az cdn custom-domain show

Rufen Sie eine vorhandene benutzerdefinierte Domäne innerhalb eines Endpunkts ab.

 Kern GA
az cdn custom-domain update

Aktualisieren einer neuen benutzerdefinierten Domäne innerhalb eines Endpunkts.

 Kern GA
az cdn custom-domain wait

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

 Kern GA

az cdn custom-domain create

Bearbeiten

Erstellen Sie eine neue benutzerdefinierte Domäne innerhalb eines Endpunkts.

az cdn custom-domain create --custom-domain-name
                            --endpoint-name
                            --profile-name
                            --resource-group
                            [--hostname]
                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Beispiele

Erstellen Sie eine benutzerdefinierte Domäne mit dem Ressourcennamen customdomain1 innerhalb eines Endpunkts und Profils.

az cdn custom-domain create -g group --endpoint-name endpoint --profile-name profile -n customdomain1 --hostname www.example.com

Erforderliche Parameter

--custom-domain-name --name -n

Name der benutzerdefinierten Domäne innerhalb eines Endpunkts.

--endpoint-name

Name des Endpunkts unter dem Profil, das global eindeutig ist.

--profile-name

Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.

--resource-group -g

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

Optionale Parameter

--hostname

Der Hostname der benutzerdefinierten Domäne. Muss ein Domänenname sein.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az cdn custom-domain delete

Bearbeiten

Löschen Einer vorhandenen benutzerdefinierten Domäne innerhalb eines Endpunkts.

az cdn custom-domain delete [--custom-domain-name]
                            [--endpoint-name]
                            [--ids]
                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                            [--profile-name]
                            [--resource-group]
                            [--subscription]

Beispiele

Löschen Sie die benutzerdefinierte Domäne eines CDN.

az cdn custom-domain delete -g group --endpoint-name endpoint --profile-name profile -n customdomain1

Optionale Parameter

--custom-domain-name --name -n

Name der benutzerdefinierten Domäne innerhalb eines Endpunkts.

--endpoint-name

Name des Endpunkts unter dem Profil, das global eindeutig ist.

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--profile-name

Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az cdn custom-domain disable-https

Bearbeiten

Deaktivieren Sie die HTTPS-Übermittlung der benutzerdefinierten Domäne.

az cdn custom-domain disable-https --endpoint-name
                                   --name
                                   --profile-name
                                   --resource-group

Erforderliche Parameter

--endpoint-name

Name des Endpunkts unter dem Profil, das global eindeutig ist.

--name -n

Ressourcenname der benutzerdefinierten Domäne.

--profile-name

Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.

--resource-group -g

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az cdn custom-domain enable-https

Bearbeiten

Aktivieren Sie HTTPS für eine benutzerdefinierte Domäne. Der Ressourcenname der benutzerdefinierten Domäne kann mit "az cdn custom-domain list" abgerufen werden.

az cdn custom-domain enable-https --endpoint-name
                                  --name
                                  --profile-name
                                  --resource-group
                                  [--min-tls-version {1.0, 1.2, none}]
                                  [--user-cert-group-name]
                                  [--user-cert-protocol-type {ip, sni}]
                                  [--user-cert-secret-name]
                                  [--user-cert-secret-version]
                                  [--user-cert-subscription-id]
                                  [--user-cert-vault-name]

Beispiele

Aktivieren von HTTPS für benutzerdefinierte Domäne mit benutzerdefinierter Ressourcendomäne1 mithilfe eines CDN-verwalteten Zertifikats

az cdn custom-domain enable-https -g group --profile-name profile --endpoint-name endpoint -n customdomain1

Aktivieren von HTTPS für benutzerdefinierte Domäne mit ressourcenname customdomain1 mithilfe eines CDN-verwalteten Zertifikats und Festlegen der mindesten TLS-Version auf 1.2

az cdn custom-domain enable-https -g group --profile-name profile --endpoint-name endpoint -n customdomain1 --min-tls-version 1.2

Erforderliche Parameter

--endpoint-name

Name des übergeordneten Endpunkts.

--name -n

Ressourcenname der benutzerdefinierten Domäne.

--profile-name

Name des übergeordneten Profils.

--resource-group -g

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

Optionale Parameter

--min-tls-version

Die minimale TLS-Version, die für die benutzerdefinierte Domäne erforderlich ist.

Zulässige Werte: 1.0, 1.2, none
--user-cert-group-name

Die Ressourcengruppe des KeyVault-Zertifikats.

--user-cert-protocol-type

Der Protokolltyp des Zertifikats.

Zulässige Werte: ip, sni
--user-cert-secret-name

Der geheime Name des KeyVault-Zertifikats.

--user-cert-secret-version

Wenn nicht angegeben, wird die geheime Version des KeyVault-Zertifikats immer verwendet, und das bereitgestellte Zertifikat wird automatisch auf die neueste Version gedreht, wenn eine neuere Version des Zertifikats verfügbar ist.

--user-cert-subscription-id

Die Abonnement-ID des KeyVault-Zertifikats.

--user-cert-vault-name

Der Tresorname des KeyVault-Zertifikats.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az cdn custom-domain list

Bearbeiten

Listet alle vorhandenen benutzerdefinierten Domänen innerhalb eines Endpunkts auf.

az cdn custom-domain list --endpoint-name
                          --profile-name
                          --resource-group
                          [--max-items]
                          [--next-token]

Erforderliche Parameter

--endpoint-name

Name des Endpunkts unter dem Profil, das global eindeutig ist.

--profile-name

Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.

--resource-group -g

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

Optionale Parameter

--max-items

Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtanzahl der verfügbaren Elemente größer als der angegebene Wert ist, wird ein Token in der Ausgabe des Befehls bereitgestellt. Um die Paginierung fortzusetzen, geben Sie den Tokenwert in --next-token Argument eines nachfolgenden Befehls an.

--next-token

Token, das angibt, wo die Paginierung beginnen soll. Dies ist der Tokenwert aus einer zuvor abgeschnittenen Antwort.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az cdn custom-domain show

Bearbeiten

Rufen Sie eine vorhandene benutzerdefinierte Domäne innerhalb eines Endpunkts ab.

az cdn custom-domain show [--custom-domain-name]
                          [--endpoint-name]
                          [--ids]
                          [--profile-name]
                          [--resource-group]
                          [--subscription]

Beispiele

Rufen Sie die Details einer benutzerdefinierten Domäne mit dem Ressourcennamen "customdomain1" ab.

az cdn custom-domain show -g group --endpoint-name endpoint --profile-name profile -n customdomain1

Optionale Parameter

--custom-domain-name --name -n

Name der benutzerdefinierten Domäne innerhalb eines Endpunkts.

--endpoint-name

Name des Endpunkts unter dem Profil, das global eindeutig ist.

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--profile-name

Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az cdn custom-domain update

Bearbeiten

Aktualisieren einer neuen benutzerdefinierten Domäne innerhalb eines Endpunkts.

az cdn custom-domain update [--add]
                            [--custom-domain-name]
                            [--endpoint-name]
                            [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                            [--hostname]
                            [--ids]
                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                            [--profile-name]
                            [--remove]
                            [--resource-group]
                            [--set]
                            [--subscription]

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--custom-domain-name --name -n

Name der benutzerdefinierten Domäne innerhalb eines Endpunkts.

--endpoint-name

Name des Endpunkts unter dem Profil, das global eindeutig ist.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--hostname

Der Hostname der benutzerdefinierten Domäne. Muss ein Domänenname sein.

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--profile-name

Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

--resource-group -g

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

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az cdn custom-domain wait

Bearbeiten

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

az cdn custom-domain wait [--created]
                          [--custom]
                          [--custom-domain-name]
                          [--deleted]
                          [--endpoint-name]
                          [--exists]
                          [--ids]
                          [--interval]
                          [--profile-name]
                          [--resource-group]
                          [--subscription]
                          [--timeout]
                          [--updated]

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False
--custom

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

--custom-domain-name --name -n

Name der benutzerdefinierten Domäne innerhalb eines Endpunkts.

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--endpoint-name

Name des Endpunkts unter dem Profil, das global eindeutig ist.

--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--interval

Abrufintervall in Sekunden.

Standardwert: 30
--profile-name

Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.