Delen via


az iot ops broker listener port

Note

This reference is part of the azure-iot-ops extension for the Azure CLI (version 2.62.0 or higher). De extensie installeert automatisch de eerste keer dat u een az iot ops broker listener port command uitvoert. Learn more about extensions.

Poortbewerkingen voor Mqtt Broker-listener.

Opdracht

Name Description Type Status
az iot ops broker listener port add

Voeg een tcp-poortconfiguratie toe aan een mqtt Broker-listenerservice.

Extension GA
az iot ops broker listener port remove

Verwijder een tcp-poortconfiguratie uit een mqtt Broker-listenerservice.

Extension GA

az iot ops broker listener port add

Voeg een tcp-poortconfiguratie toe aan een mqtt Broker-listenerservice.

Dit is een bewerking voor toevoegen of vervangen (poort). Als de doellistenerresource niet bestaat, wordt deze door de opdracht gemaakt.

az iot ops broker listener port add --instance
                                    --listener
                                    --port
                                    --resource-group
                                    [--authn-ref]
                                    [--authz-ref]
                                    [--broker]
                                    [--nodeport]
                                    [--protocol {Mqtt, WebSockets}]
                                    [--service-name]
                                    [--service-type {ClusterIp, LoadBalancer, NodePort}]
                                    [--show-config {false, true}]
                                    [--tls-duration]
                                    [--tls-issuer-ref]
                                    [--tls-key-algo {Ec256, Ec384, Ec521, Ed25519, Rsa2048, Rsa4096, Rsa8192}]
                                    [--tls-key-rotation {Always, Never}]
                                    [--tls-man-secret-ref]
                                    [--tls-renew-before]
                                    [--tls-san-dns]
                                    [--tls-san-ip]
                                    [--tls-secret-name]

Voorbeelden

Voeg een poortconfiguratie toe aan de standaardcluster-IP-listener met behulp van poort 8883 en een verificatieresource.

az iot ops broker listener port add --port 8883 --authn authn --listener default --in myinstance -g mygroup

Maak een nieuwe listener met load balancer van het servicetype met behulp van een poortconfiguratie die tcp-verbindingen accepteert op poort 1883 zonder verificatie of verificatie.

az iot ops broker listener port add --port 1883 --listener newlistener --in myinstance -g mygroup

Voeg een poortconfiguratie toe aan een bestaande listener met behulp van standaardinstellingen voor automatische tls op poort 8883 met verificatie.

az iot ops broker listener port add --port 8883 --authn authn --tls-issuer-ref issuer=azure-iot-operations-aio-certificate-issuer kind=ClusterIssuer --listener newlistener --in myinstance -g mygroup

Vereiste parameters

--instance -i

Naam ioT Operations-exemplaar.

--listener -n

Listener name.

--port

Listener-servicepoort.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--authn-ref

Verificatiereferentie (naam).

Eigenschap Waarde
Parameter group: Auth Arguments
--authz-ref

Autorisatiereferentie (naam).

Eigenschap Waarde
Parameter group: Auth Arguments
--broker -b

Broker name.

Eigenschap Waarde
Default value: default
--nodeport

De listenerservice maakt een statische poort beschikbaar op het IP-adres van elk knooppunt. Alleen relevant wanneer deze poort is gekoppeld aan een NodePort-listener.

Eigenschap Waarde
Parameter group: Node Port Arguments
--protocol

Protocol dat moet worden gebruikt voor clientverbindingen.

Eigenschap Waarde
Geaccepteerde waarden: Mqtt, WebSockets
--service-name

Kubernetes-servicenaam van de listener. Wordt gebruikt wanneer er geen doellistener bestaat.

--service-type

Kubernetes-servicetype van de listener. Wordt gebruikt wanneer er geen doellistener bestaat.

Eigenschap Waarde
Default value: LoadBalancer
Geaccepteerde waarden: ClusterIp, LoadBalancer, NodePort
--show-config

De gegenereerde resourceconfiguratie weergeven in plaats van de API eraan aan te roepen.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--tls-duration

Levensduur van het certificaat. Moet worden opgegeven met behulp van een tijd. Duurnotatie (h|m|s). Bijvoorbeeld 240 uur gedurende 240 uur en 45m gedurende 45 minuten.

Eigenschap Waarde
Parameter group: TLS Auto Arguments
--tls-issuer-ref

Naslaginformatie voor Cert-manager-verleners. De notatie is door spaties gescheiden sleutelparen. De volgende sleutels worden ondersteund: group, kind, name. kind en name zijn vereist, terwijl group de standaardwaarde 'cert-manager.io' is.

Eigenschap Waarde
Parameter group: TLS Auto Arguments
--tls-key-algo

Algoritme voor persoonlijke sleutel.

Eigenschap Waarde
Parameter group: TLS Auto Arguments
Geaccepteerde waarden: Ec256, Ec384, Ec521, Ed25519, Rsa2048, Rsa4096, Rsa8192
--tls-key-rotation

Certificaatbeheerbeleid voor het rouleren van persoonlijke sleutels.

Eigenschap Waarde
Parameter group: TLS Auto Arguments
Geaccepteerde waarden: Always, Never
--tls-man-secret-ref

Geheim met een X.509-clientcertificaat. Dit is een verwijzing naar het geheim via een identificatienaam, niet het geheim zelf.

Eigenschap Waarde
Parameter group: TLS Manual Arguments
--tls-renew-before

Wanneer moet u het certificaat vernieuwen. Moet worden opgegeven met een Go-tijd. Duurnotatie (h|m|s). Bijvoorbeeld 240 uur gedurende 240 uur en 45m gedurende 45 minuten.

Eigenschap Waarde
Parameter group: TLS Auto Arguments
--tls-san-dns

Alternatieve dns-onderwerpnamen voor het certificaat. Gebruik door spaties gescheiden waarden.

Eigenschap Waarde
Parameter group: TLS Auto Arguments
--tls-san-ip

Alternatieve ip-onderwerpnamen voor het certificaat. Gebruik door spaties gescheiden waarden.

Eigenschap Waarde
Parameter group: TLS Auto Arguments
--tls-secret-name

Geheim voor het opslaan van servercertificaat. Alle bestaande gegevens worden overschreven. Dit is een verwijzing naar het geheim via een identificatienaam, niet het geheim zelf.

Eigenschap Waarde
Parameter group: TLS Auto Arguments
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az iot ops broker listener port remove

Verwijder een tcp-poortconfiguratie uit een mqtt Broker-listenerservice.

Als er na het verwijderen geen TCP-poorten bestaan, wordt de listenerresource verwijderd.

az iot ops broker listener port remove --instance
                                       --listener
                                       --port
                                       --resource-group
                                       [--broker]
                                       [--yes {false, true}]

Voorbeelden

Verwijder tcp-poort 1883-configuratie uit een listener. De listener wordt verwijderd als er geen poorten blijven.

az iot ops broker listener port remove --port 1883 --listener mylistener --in myinstance -g mygroup

Vereiste parameters

--instance -i

Naam ioT Operations-exemplaar.

--listener -n

Listener name.

--port

Listener-servicepoort.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--broker -b

Broker name.

Eigenschap Waarde
Default value: default
--yes -y

Bevestig [y]s zonder prompt. Handig voor CI- en automatiseringsscenario's.

Eigenschap Waarde
Geaccepteerde waarden: false, true
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False