Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Interfejs wiersza polecenia platformy Azure służy do tworzenia zasobów platformy Azure i zarządzania nimi z poziomu wiersza polecenia lub skryptów. Ten przewodnik Szybki start zawiera szczegółowe informacje dotyczące tworzenia centrum IoT i wystąpienia usługi IoT Hub Device Provisioning przy użyciu interfejsu wiersza polecenia platformy Azure oraz łączenia obu usług.
Jeśli nie masz jeszcze konta platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
Ważne
Zarówno centrum IoT, jak i utworzona w tym przewodniku Szybki start usługa aprowizacji są publicznie odnajdywalne jako punkty końcowe DNS. Pamiętaj, aby uniknąć wszelkich poufnych informacji, jeśli zdecydujesz się zmienić nazwy używane dla tych zasobów.
Wymagania wstępne
Użyj środowiska Bash w Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Get started with Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj Azure CLI. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie Azure CLI w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić Azure CLI w kontenerze Docker.
Jeśli korzystasz z instalacji lokalnej, zaloguj się do Azure CLI za pomocą polecenia az login. Aby zakończyć proces uwierzytelniania, wykonaj kroki wyświetlane na Twoim terminalu. Aby uzyskać inne opcje logowania, zobacz Uwierzytelnianie na platformie Azure przy użyciu interfejsu wiersza polecenia platformy Azure.
Gdy zostaniesz o to poproszony/a, zainstaluj rozszerzenie Azure CLI przy pierwszym użyciu. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Używanie rozszerzeń i zarządzanie nimi za pomocą interfejsu wiersza polecenia platformy Azure.
Uruchom az version, aby sprawdzić zainstalowaną wersję i biblioteki zależne. Aby zaktualizować do najnowszej wersji, uruchom az upgrade.
Tworzenie grupy zasobów
Utwórz grupę zasobów za pomocą polecenia az group create. Grupa zasobów platformy Azure to logiczny kontener przeznaczony do wdrażania zasobów platformy Azure i zarządzania nimi.
Poniższy przykład tworzy grupę zasobów o nazwie my-sample-resource-group w lokalizacji westus .
az group create --name my-sample-resource-group --location westus
Wskazówka
Przykład tworzy grupę zasobów w lokalizacji Zachodnie USA. Listę dostępnych lokalizacji można wyświetlić, uruchamiając polecenie az account list-locations -o table.
Tworzenie centrum IoT
Utwórz centrum IoT za pomocą polecenia az iot hub create .
Poniższy przykład tworzy centrum IoT o nazwie my-sample-hub w lokalizacji westus . Nazwa centrum IoT musi być globalnie unikatowa na platformie Azure, dlatego dodaj unikatowy prefiks lub sufiks do przykładowej nazwy lub całkowicie wybierz nową nazwę. Upewnij się, że nazwa jest zgodna z odpowiednimi konwencjami nazewnictwa centrum IoT: powinna mieć długość od 3 do 50 znaków i może zawierać tylko wielkie lub małe litery alfanumeryczne lub łączniki ('-').
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus
Utwórz wystąpienie usługi Device Provisioning Service
Utwórz wystąpienie usługi Device Provisioning Service, używając polecenia az iot dps create.
Poniższy przykład tworzy wystąpienie usługi Device Provisioning Service o nazwie my-sample-dps w lokalizacji westus . Musisz również wybrać globalnie unikatową nazwę dla własnego wystąpienia. Upewnij się, że są zgodne z odpowiednimi konwencjami nazewnictwa dla usługi IoT Hub Device Provisioning Service: powinna mieć długość od 3 do 64 znaków i może zawierać tylko wielkie lub małe litery alfanumeryczne lub łączniki ('-').
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus
Wskazówka
Przykład tworzy usługę aprowizacji w lokalizacji Zachodnia część USA. Listę dostępnych lokalizacji można wyświetlić, uruchamiając polecenie az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table lub przechodząc do strony Stan platformy Azure i wyszukując frazę "Device Provisioning Service". W poleceniach lokalizacje można określić w formacie jednego wyrazu lub z wieloma wyrazami; na przykład: westus, West US, WEST US itp. Wartość nie uwzględnia wielkości liter. Jeśli używasz formatu wielosłownego do określania lokalizacji, należy ująć wartość w cudzysłowy; na przykład --location "West US".
W celu zapewnienia odporności i niezawodności zalecamy wdrożenie w jednym z regionów obsługujących Strefy dostępności.
Pobierz łańcuch połączenia dla centrum IoT
Potrzebujesz parametrów połączenia centrum IoT Hub, aby połączyć je z usługą Device Provisioning Service. Użyj polecenia az iot hub connection-string show , aby pobrać parametry połączenia i użyć jego danych wyjściowych, aby ustawić zmienną używaną później, podczas łączenia dwóch zasobów.
Poniższy przykład ustawia zmienną hubConnectionString na wartość ciągu połączenia dla klucza podstawowego polityki iothubowner węzła (ten parametr można użyć do określenia innej polityki). Zamień my-sample-hub na unikatową nazwę centrum IoT, którą wybrałeś wcześniej. Polecenie używa opcji zapytań i danych wyjściowych interfejsu wiersza polecenia platformy Azure, aby wyodrębnić parametry połączenia z danych wyjściowych polecenia.
hubConnectionString=$(az iot hub connection-string show --name my-sample-hub --key primary --query connectionString -o tsv)
Możesz użyć echo polecenia , aby wyświetlić parametry połączenia.
echo $hubConnectionString
Uwaga / Notatka
Te dwa polecenia są prawidłowe dla hosta uruchomionego w ramach powłoki Bash.
Jeśli używasz lokalnego shellu systemu Windows/CMD lub hosta programu PowerShell, zmodyfikuj komendy, aby użyć poprawnej składni dla tego środowiska.
Jeśli używasz usługi Azure Cloud Shell, sprawdź, czy menu rozwijane środowiska po lewej stronie okna powłoki wskazuje Bash.
Łączenie centrum IoT i usługi aprowizacji
Połącz centrum IoT i usługę aprowizacji za pomocą polecenia az iot dps linked-hub create .
Poniższy przykład zawiera linki do centrum IoT o nazwie my-sample-hub w lokalizacji westus i usługi Device Provisioning o nazwie my-sample-dps. Zamień te nazwy na unikatowe nazwy centrum IoT i usługi wdrażania urządzeń, które zostały wybrane wcześniej. Polecenie używa ciągu połączenia dla Twojego centrum IoT, który został przechowany w zmiennej hubConnectionString w poprzednim kroku.
az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus
Wykonanie polecenia może potrwać kilka minut.
Zweryfikuj usługę aprowizacji
Uzyskaj szczegółowe informacje na temat usługi aprowizacji za pomocą polecenia az iot dps show.
Poniższy przykład zawiera szczegółowe informacje o usłudze aprowizacji o nazwie my-sample-dps. Zamień tę nazwę na własną nazwę usługi Device Provisioning Service.
az iot dps show --name my-sample-dps
Połączone centrum IoT jest wyświetlane w kolekcji properties.iotHubs.
Przechwycenie ekranu okna Azure Cloud Shell, na którym wyróżniono kolekcję properties.iotHubs, wyświetlaną w wynikach polecenia az iot dps show.
Uprzątnij zasoby
Inne szybkie starty w tej kolekcji bazują na tym szybkim starcie. Jeśli planujesz kontynuować pracę z kolejnymi przewodnikami Szybki start lub samouczkami, nie usuwaj zasobów utworzonych w tym przewodniku Szybki start. Jeśli nie planujesz kontynuować, możesz użyć następujących poleceń, aby usunąć usługę aprowizacji, centrum IoT lub grupę zasobów i wszystkie jej zasoby. Zastąp nazwy zasobów zawartych w poniższych poleceniach nazwami własnych zasobów.
Aby usunąć usługę aprowizacji, uruchom polecenie az iot dps delete :
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
Aby usunąć centrum IoT Hub, uruchom polecenie az iot hub delete :
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
Aby usunąć grupę zasobów i wszystkie jej zasoby, uruchom polecenie az group delete :
az group delete --name my-sample-resource-group
Dalsze kroki
W tym Szybkim starcie wdrożono koncentrator IoT oraz wystąpienie usługi Device Provisioning Service, a także połączono te dwa zasoby. Aby dowiedzieć się, jak za pomocą tej konfiguracji aprowizować urządzenie, przejdź do przewodnika Szybki start dotyczącego tworzenia urządzenia.