az iot hub message-endpoint update
Uwaga
Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.46.0 lub nowsza). Rozszerzenie automatycznie zainstaluje polecenie az iot hub message-endpoint update po raz pierwszy. Dowiedz się więcej o rozszerzeniach.
Grupa poleceń "iot hub message-endpoint" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Zaktualizuj właściwości istniejącego punktu końcowego dla usługi IoT Hub.
Polecenia
Nazwa | Opis | Typ | Stan |
---|---|---|---|
az iot hub message-endpoint update cosmosdb-container |
Zaktualizuj właściwości istniejącego punktu końcowego kontenera usługi Cosmos DB dla usługi IoT Hub. |
Numer wewnętrzny | Wersja Preview |
az iot hub message-endpoint update eventhub |
Zaktualizuj właściwości istniejącego punktu końcowego centrum zdarzeń dla usługi IoT Hub. |
Numer wewnętrzny | Wersja Preview |
az iot hub message-endpoint update servicebus-queue |
Zaktualizuj właściwości istniejącego punktu końcowego kolejki usługi Service Bus dla usługi IoT Hub. |
Numer wewnętrzny | Wersja Preview |
az iot hub message-endpoint update servicebus-topic |
Zaktualizuj właściwości istniejącego punktu końcowego tematu usługi Service Bus dla usługi IoT Hub. |
Numer wewnętrzny | Wersja Preview |
az iot hub message-endpoint update storage-container |
Zaktualizuj właściwości istniejącego punktu końcowego kontenera magazynu dla usługi IoT Hub. |
Numer wewnętrzny | Wersja Preview |
az iot hub message-endpoint update cosmosdb-container
Grupa poleceń "iot hub message-endpoint" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Zaktualizuj właściwości istniejącego punktu końcowego kontenera usługi Cosmos DB dla usługi IoT Hub.
W przypadku aktualizowania typu uwierzytelniania z opartego na kluczach do opartego na tożsamości punktu końcowego kontenera usługi Cosmos DB należy podać tożsamość (za pośrednictwem --identity) i identyfikator URI punktu końcowego (za pośrednictwem --endpoint-uri). Stary klucz podstawowy i klucz pomocniczy będą mieć wartość null.
W przypadku aktualizowania typu uwierzytelniania z opartego na tożsamości do opartego na kluczach punktu końcowego kontenera usługi Cosmos DB należy podać parametry połączenia (za pośrednictwem --connection-string), klucz podstawowy (za pośrednictwem --primary-key) lub klucz pomocniczy (za pośrednictwem --secondary-key).
Nie można zmienić nazwy kontenera dla punktu końcowego. Nazwy kont można zmienić tylko wtedy, gdy kontenery o tej samej nazwie istnieją na obu kontach.
az iot hub message-endpoint update cosmosdb-container --en
--hub-name
[--connection-string]
[--database-name]
[--endpoint-resource-group]
[--endpoint-subscription-id]
[--endpoint-uri]
[--identity]
[--partition-key-name]
[--partition-key-template]
[--pk]
[--resource-group]
[--secondary-key]
Przykłady
Zaktualizuj punkt końcowy kontenera usługi Cosmos DB oparty na kluczach lub tożsamości dla usługi IoT Hub, aby użyć nowego określonego parametry połączenia.
az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --connection-string {connection_string}
Zaktualizuj punkt końcowy kontenera usługi Cosmos DB dla usługi IoT Hub, aby użyć określonego klucza podstawowego i klucza pomocniczego.
az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --pk {primary_key} --sk {secondary_key}
Zaktualizuj punkt końcowy kontenera usługi Cosmos DB dla usługi IoT Hub, aby używać tożsamości przypisanej przez system i nazwy klucza partycji. Szablon klucza partycji będzie domyślny.
az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --pkn {partition_key_name} --identity [system]
Zaktualizuj punkt końcowy kontenera usługi Cosmos DB oparty na kluczach dla usługi IoT Hub, aby użyć tożsamości przypisanej przez użytkownika (możesz pominąć identyfikator --endpoint-URI, jeśli punkt końcowy jest już oparty na tożsamości).
az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri}
Parametry wymagane
Nazwa punktu końcowego routingu.
Nazwa centrum IoT Hub.
Parametry opcjonalne
Parametry połączenia punktu końcowego routingu.
Nazwa bazy danych cosmos DB na koncie usługi Cosmos DB.
Grupa zasobów zasobu zasobu punktu końcowego. Jeśli nie zostanie podana, zostanie użyta grupa zasobów usługi IoT Hub.
Identyfikator subskrypcji zasobu punktu końcowego. Jeśli nie zostanie podana, zostanie użyta subskrypcja usługi IoT Hub.
Identyfikator URI zasobu punktu końcowego.
Użyj przypisanej przez system lub przypisanej przez użytkownika tożsamości zarządzanej na potrzeby uwierzytelniania punktu końcowego. Użyj polecenia "[system]", aby odwołać się do tożsamości przypisanej przez system lub identyfikatora zasobu, aby odwołać się do tożsamości przypisanej przez użytkownika.
Nazwa klucza partycji skojarzonego z tym kontenerem SQL usługi Cosmos DB, jeśli istnieje. Aby wyczyścić tę właściwość, ustaw tę właściwość na "".
Szablon służący do generowania syntetycznej wartości klucza partycji do użycia z tym kontenerem SQL usługi Cosmos DB. Szablon musi zawierać co najmniej jeden z następujących symboli zastępczych: {iothub}, {deviceid}, {DD}, {MM}i {RRRR}. Każdy symbol zastępczy może być określony co najwyżej raz, ale składniki kolejności i symbolu zastępczego są dowolne. Jeśli podano nazwę klucza partycji, szablon klucza partycji jest domyślnie ustawiona na {deviceid}-{RRRR}-{MM}. Aby wyczyścić tę właściwość, ustaw tę właściwość na "".
Klucz podstawowy konta usługi Cosmos DB.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Klucz pomocniczy konta usługi Cosmos DB.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az iot hub message-endpoint update eventhub
Grupa poleceń "iot hub message-endpoint" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Zaktualizuj właściwości istniejącego punktu końcowego centrum zdarzeń dla usługi IoT Hub.
W przypadku aktualizowania typu uwierzytelniania z opartego na kluczu do punktu końcowego centrum zdarzeń opartego na tożsamości należy podać tożsamość (za pośrednictwem --identity), identyfikator URI punktu końcowego (za pośrednictwem --endpoint-uri) i ścieżkę jednostki (za pośrednictwem --entity-path). Stare parametry połączenia zostaną unieważnione.
W przypadku aktualizowania typu uwierzytelniania z punktu końcowego opartego na tożsamości na punkt końcowy centrum zdarzeń opartych na kluczach należy podać parametry połączenia (za pośrednictwem parametrów --connection-). Stary identyfikator URI punktu końcowego i ścieżka jednostki będą mieć wartość null.
az iot hub message-endpoint update eventhub --en
--hub-name
[--connection-string]
[--endpoint-resource-group]
[--endpoint-subscription-id]
[--endpoint-uri]
[--entity-path]
[--identity]
[--resource-group]
Przykłady
Zaktualizuj punkt końcowy centrum zdarzeń oparty na kluczach lub tożsamości dla usługi IoT Hub, aby użyć nowego określonego parametry połączenia.
az iot hub message-endpoint update eventhub -n {iothub_name} --en {endpoint_name} -c {connection_string}
Zaktualizuj punkt końcowy centrum zdarzeń dla usługi IoT Hub, aby używać tożsamości przypisanej przez system i innej ścieżki jednostki.
az iot hub message-endpoint update eventhub -n {iothub_name} --en {endpoint_name} --entity-path {entity_path} --identity [system]
Zaktualizuj punkt końcowy centrum zdarzeń oparty na kluczach dla usługi IoT Hub, aby użyć tożsamości przypisanej przez użytkownika (możesz pominąć identyfikator --endpoint-URI, jeśli punkt końcowy jest już oparty na tożsamości).
az iot hub message-endpoint update eventhub -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri} --entity-path {entity_path}
Parametry wymagane
Nazwa punktu końcowego routingu.
Nazwa centrum IoT Hub.
Parametry opcjonalne
Parametry połączenia punktu końcowego routingu.
Grupa zasobów zasobu zasobu punktu końcowego. Jeśli nie zostanie podana, zostanie użyta grupa zasobów usługi IoT Hub.
Identyfikator subskrypcji zasobu punktu końcowego. Jeśli nie zostanie podana, zostanie użyta subskrypcja usługi IoT Hub.
Identyfikator URI zasobu punktu końcowego.
Ścieżka jednostki zasobu punktu końcowego.
Użyj przypisanej przez system lub przypisanej przez użytkownika tożsamości zarządzanej na potrzeby uwierzytelniania punktu końcowego. Użyj polecenia "[system]", aby odwołać się do tożsamości przypisanej przez system lub identyfikatora zasobu, aby odwołać się do tożsamości przypisanej przez użytkownika.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az iot hub message-endpoint update servicebus-queue
Grupa poleceń "iot hub message-endpoint" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Zaktualizuj właściwości istniejącego punktu końcowego kolejki usługi Service Bus dla usługi IoT Hub.
W przypadku aktualizowania typu uwierzytelniania z opartego na kluczach do punktu końcowego kolejki usługi Service Bus opartego na tożsamości należy podać tożsamość (za pośrednictwem --identity), identyfikator URI punktu końcowego (za pośrednictwem --endpoint-uri) i ścieżkę jednostki (za pośrednictwem --entity-path). Stare parametry połączenia zostaną unieważnione.
W przypadku aktualizowania typu uwierzytelniania z opartego na tożsamości do punktu końcowego kolejki usługi Service Bus opartego na kluczach należy podać parametry połączenia (za pośrednictwem --connection-string). Stary identyfikator URI punktu końcowego i ścieżka jednostki będą mieć wartość null.
az iot hub message-endpoint update servicebus-queue --en
--hub-name
[--connection-string]
[--endpoint-resource-group]
[--endpoint-subscription-id]
[--endpoint-uri]
[--entity-path]
[--identity]
[--resource-group]
Przykłady
Zaktualizuj punkt końcowy kolejki usługi Service Bus oparty na kluczach lub tożsamości dla usługi IoT Hub, aby użyć nowego określonego parametry połączenia.
az iot hub message-endpoint update servicebus-queue -n {iothub_name} --en {endpoint_name} -c {connection_string}
Zaktualizuj punkt końcowy kolejki usługi Service Bus dla usługi IoT Hub, aby używać tożsamości przypisanej przez system i innej ścieżki jednostki.
az iot hub message-endpoint update servicebus-queue -n {iothub_name} --en {endpoint_name} --entity-path {entity_path} --identity [system]
Zaktualizuj punkt końcowy kolejki usługi Service Bus oparty na kluczach dla usługi IoT Hub, aby użyć tożsamości przypisanej przez użytkownika (możesz pominąć identyfikator --endpoint-URI, jeśli punkt końcowy jest już oparty na tożsamości).
az iot hub message-endpoint update servicebus-queue -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri} --entity-path {entity_path}
Parametry wymagane
Nazwa punktu końcowego routingu.
Nazwa centrum IoT Hub.
Parametry opcjonalne
Parametry połączenia punktu końcowego routingu.
Grupa zasobów zasobu zasobu punktu końcowego. Jeśli nie zostanie podana, zostanie użyta grupa zasobów usługi IoT Hub.
Identyfikator subskrypcji zasobu punktu końcowego. Jeśli nie zostanie podana, zostanie użyta subskrypcja usługi IoT Hub.
Identyfikator URI zasobu punktu końcowego.
Ścieżka jednostki zasobu punktu końcowego.
Użyj przypisanej przez system lub przypisanej przez użytkownika tożsamości zarządzanej na potrzeby uwierzytelniania punktu końcowego. Użyj polecenia "[system]", aby odwołać się do tożsamości przypisanej przez system lub identyfikatora zasobu, aby odwołać się do tożsamości przypisanej przez użytkownika.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az iot hub message-endpoint update servicebus-topic
Grupa poleceń "iot hub message-endpoint" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Zaktualizuj właściwości istniejącego punktu końcowego tematu usługi Service Bus dla usługi IoT Hub.
W przypadku aktualizowania typu uwierzytelniania z opartego na kluczach do punktu końcowego tematu usługi Service Bus opartego na tożsamości należy podać tożsamość (za pośrednictwem --identity), identyfikator URI punktu końcowego (za pośrednictwem --endpoint-uri) i ścieżkę jednostki (za pośrednictwem --entity-path). Stare parametry połączenia zostaną unieważnione.
W przypadku aktualizowania typu uwierzytelniania z opartego na tożsamości do opartego na kluczach punktu końcowego tematu usługi Service Bus należy podać parametry połączenia (za pośrednictwem parametrów --connection-). Stary identyfikator URI punktu końcowego i ścieżka jednostki będą mieć wartość null.
az iot hub message-endpoint update servicebus-topic --en
--hub-name
[--connection-string]
[--endpoint-resource-group]
[--endpoint-subscription-id]
[--endpoint-uri]
[--entity-path]
[--identity]
[--resource-group]
Przykłady
Aktualizowanie punktu końcowego tematu usługi Service Bus opartego na kluczach lub tożsamości dla usługi IoT Hub w celu użycia nowego określonego parametry połączenia.
az iot hub message-endpoint update servicebus-topic -n {iothub_name} --en {endpoint_name} -c {connection_string}
Zaktualizuj punkt końcowy tematu usługi Service Bus dla usługi IoT Hub, aby używać tożsamości przypisanej przez system i innej ścieżki jednostki.
az iot hub message-endpoint update servicebus-topic -n {iothub_name} --en {endpoint_name} --entity-path {entity_path} --identity [system]
Zaktualizuj punkt końcowy tematu usługi Service Bus opartego na kluczach dla usługi IoT Hub, aby użyć tożsamości przypisanej przez użytkownika (możesz pominąć identyfikator --endpoint-URI, jeśli punkt końcowy jest już oparty na tożsamości).
az iot hub message-endpoint update servicebus-topic -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri} --entity-path {entity_path}
Parametry wymagane
Nazwa punktu końcowego routingu.
Nazwa centrum IoT Hub.
Parametry opcjonalne
Parametry połączenia punktu końcowego routingu.
Grupa zasobów zasobu zasobu punktu końcowego. Jeśli nie zostanie podana, zostanie użyta grupa zasobów usługi IoT Hub.
Identyfikator subskrypcji zasobu punktu końcowego. Jeśli nie zostanie podana, zostanie użyta subskrypcja usługi IoT Hub.
Identyfikator URI zasobu punktu końcowego.
Ścieżka jednostki zasobu punktu końcowego.
Użyj przypisanej przez system lub przypisanej przez użytkownika tożsamości zarządzanej na potrzeby uwierzytelniania punktu końcowego. Użyj polecenia "[system]", aby odwołać się do tożsamości przypisanej przez system lub identyfikatora zasobu, aby odwołać się do tożsamości przypisanej przez użytkownika.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az iot hub message-endpoint update storage-container
Grupa poleceń "iot hub message-endpoint" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Zaktualizuj właściwości istniejącego punktu końcowego kontenera magazynu dla usługi IoT Hub.
W przypadku aktualizowania typu uwierzytelniania z opartego na kluczach do punktu końcowego kontenera magazynu opartego na tożsamości należy podać tożsamość (za pośrednictwem --identity) i identyfikator URI punktu końcowego (za pośrednictwem --endpoint-uri). Stare parametry połączenia zostaną unieważnione.
W przypadku aktualizowania typu uwierzytelniania z opartego na tożsamości do opartego na kluczach punktu końcowego kontenera magazynu należy podać parametry połączenia (za pośrednictwem --connection-string).
Nie można zmienić nazwy kontenera i kodowania punktu końcowego. Nazwy kont można zmienić tylko wtedy, gdy kontenery o tej samej nazwie istnieją na obu kontach.
az iot hub message-endpoint update storage-container --en
--hub-name
[--batch-frequency]
[--chunk-size]
[--connection-string]
[--endpoint-resource-group]
[--endpoint-subscription-id]
[--endpoint-uri]
[--ff]
[--identity]
[--resource-group]
Przykłady
Zaktualizuj punkt końcowy kontenera magazynu opartego na kluczach lub tożsamości dla usługi IoT Hub, aby użyć nowego określonego parametry połączenia.
az iot hub message-endpoint update storage-container -n {iothub_name} --en {endpoint_name} -c {connection_string}
Zaktualizuj punkt końcowy kontenera magazynu dla usługi IoT Hub, aby używać tożsamości przypisanej przez system z daną częstotliwością wsadową, rozmiarem fragmentu i formatem nazwy pliku.
az iot hub message-endpoint update storage-container -n {iothub_name} --en {endpoint_name} -b {batch_frequency} -w {chunk_size} --ff {file_format} --identity [system]
Zaktualizuj punkt końcowy kontenera magazynu opartego na kluczach dla usługi IoT Hub, aby użyć tożsamości przypisanej przez użytkownika (możesz pominąć identyfikator --endpoint-uri, jeśli punkt końcowy jest już oparty na tożsamości).
az iot hub message-endpoint update storage-container -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri}
Parametry wymagane
Nazwa punktu końcowego routingu.
Nazwa centrum IoT Hub.
Parametry opcjonalne
Żądaj częstotliwości wsadowej w sekundach. Maksymalny czas, który może upłynąć przed zapisaniem danych w obiekcie blob z zakresu od 60 do 720 sekund.
Rozmiar fragmentu żądania w megabajtach (MB). Maksymalny rozmiar obiektów blob z zakresu od 10 do 500 MB.
Parametry połączenia punktu końcowego routingu.
Grupa zasobów zasobu zasobu punktu końcowego. Jeśli nie zostanie podana, zostanie użyta grupa zasobów usługi IoT Hub.
Identyfikator subskrypcji zasobu punktu końcowego. Jeśli nie zostanie podana, zostanie użyta subskrypcja usługi IoT Hub.
Identyfikator URI zasobu punktu końcowego.
Format nazwy pliku dla obiektu blob. Format nazwy pliku musi zawierać pola {iothub}, {partition}, {RRRR}, {MM}, {DD}, {HH} i {mm}. Wszystkie parametry są obowiązkowe, ale można zmienić ich kolejność z ogranicznikami lub bez nich.
Użyj przypisanej przez system lub przypisanej przez użytkownika tożsamości zarządzanej na potrzeby uwierzytelniania punktu końcowego. Użyj polecenia "[system]", aby odwołać się do tożsamości przypisanej przez system lub identyfikatora zasobu, aby odwołać się do tożsamości przypisanej przez użytkownika.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.