Tworzenie centrum IoT przy użyciu polecenia cmdlet New-AzIotHub

Polecenia cmdlet programu Azure PowerShell umożliwiają tworzenie centrów Azure IoT Hub i zarządzanie nimi. W tym samouczku pokazano, jak utworzyć centrum IoT Hub za pomocą programu PowerShell.

Uwaga

Do interakcji z platformą Azure zalecamy używanie modułu Azure Az w programie PowerShell. Zobacz Instalowanie programu Azure PowerShell, aby rozpocząć. Aby dowiedzieć się, jak przeprowadzić migrację do modułu Az PowerShell, zobacz Migracja programu Azure PowerShell z modułu AzureRM do modułu Az.

Alternatywnie możesz użyć usługi Azure Cloud Shell, jeśli nie chcesz instalować dodatkowych modułów na maszynie. W poniższej sekcji rozpoczniesz pracę z usługą Azure Cloud Shell.

Azure Cloud Shell

Na platforma Azure hostowane jest Azure Cloud Shell, interaktywne środowisko powłoki, z którego można korzystać w przeglądarce. Do pracy z usługami platformy Azure można używać programu Bash lub PowerShell w środowisku Cloud Shell. Aby uruchomić kod w tym artykule, możesz użyć wstępnie zainstalowanych poleceń usługi Cloud Shell bez konieczności instalowania niczego w środowisku lokalnym.

Aby uruchomić środowisko Azure Cloud Shell:

Opcja Przykład/link
Wybierz pozycję Wypróbuj w prawym górnym rogu bloku kodu lub polecenia. Wybranie pozycji Wypróbuj nie powoduje automatycznego skopiowania kodu lub polecenia do usługi Cloud Shell. Screenshot that shows an example of Try It for Azure Cloud Shell.
Przejdź do witryny https://shell.azure.com lub wybierz przycisk Uruchom Cloud Shell, aby otworzyć środowisko Cloud Shell w przeglądarce. Button to launch Azure Cloud Shell.
Wybierz przycisk Cloud Shell na pasku menu w prawym górnym rogu witryny Azure Portal. Screenshot that shows the Cloud Shell button in the Azure portal

Aby użyć usługi Azure Cloud Shell:

  1. Uruchom usługę Cloud Shell.

  2. Wybierz przycisk Kopiuj w bloku kodu (lub bloku poleceń), aby skopiować kod lub polecenie.

  3. Wklej kod lub polecenie do sesji usługi Cloud Shell, wybierając klawisze Ctrl+Shift V w systemach Windows i Linux lub wybierając pozycję Cmd+Shift++V w systemie macOS.

  4. Wybierz klawisz Enter, aby uruchomić kod lub polecenie.

Wymagania wstępne

Aby wdrożyć centrum IoT Hub, potrzebna jest grupa zasobów. Możesz wybrać istniejącą grupę zasobów lub utworzyć nową.

Aby utworzyć nową grupę zasobów dla centrum IoT Hub, użyj polecenia New-AzResourceGroup . W tym przykładzie jest tworzona grupa zasobów o nazwie MyIoTRG1 w regionie Wschodnie stany USA :

New-AzResourceGroup -Name MyIoTRG1 -Location "East US"

Nawiązywanie połączenia z subskrypcją platformy Azure

Jeśli używasz usługi Cloud Shell, zalogowano się już do subskrypcji, aby pominąć tę sekcję. Jeśli używasz programu PowerShell lokalnie, wprowadź następujące polecenie, aby zalogować się do subskrypcji platformy Azure:

# Log into Azure account.
Login-AzAccount

Tworzenie centrum IoT

Utwórz centrum IoT Hub przy użyciu grupy zasobów. Użyj polecenia New-AzIotHub. W tym przykładzie jest tworzone centrum S1 o nazwie MyTestIoTHub w regionie Wschodnie stany USA:

New-AzIotHub `
    -ResourceGroupName MyIoTRG1 `
    -Name MyTestIoTHub `
    -SkuName S1 -Units 1 `
    -Location "East US"

Nazwa centrum IoT musi być globalnie unikatowa.

Ważne

Ponieważ centrum IoT będzie publicznie odnajdywalne jako punkt końcowy DNS, pamiętaj, aby uniknąć wprowadzania poufnych lub osobistych informacji podczas ich nadawania nazwy.

Aby wyświetlić listę wszystkich centrów IoT w ramach subskrypcji, użyj polecenia Get-AzIotHub .

W tym przykładzie pokazano usługę S1 Standard IoT Hub utworzoną w poprzednim kroku.

Get-AzIotHub

Aby usunąć centrum IoT, użyj polecenia Remove-AzIotHub .

Remove-AzIotHub `
    -ResourceGroupName MyIoTRG1 `
    -Name MyTestIoTHub

Aktualizowanie centrum IoT

Ustawienia istniejącego centrum IoT można zmienić po jego utworzeniu. Poniżej przedstawiono niektóre właściwości, które można ustawić dla centrum IoT:

Cennik i skala: przeprowadź migrację do innej warstwy lub ustaw liczbę jednostek usługi IoT Hub.

Filtr adresów IP: określ zakres adresów IP, które zostaną zaakceptowane lub odrzucone przez centrum IoT.

Właściwości: lista właściwości, które można kopiować i używać w innych miejscach, takich jak identyfikator zasobu, grupa zasobów, lokalizacja itd.

Zapoznaj się z poleceniami Set-AzIotHub, aby uzyskać pełną listę opcji aktualizacji.

Następne kroki

Po wdrożeniu centrum IoT Hub przy użyciu polecenia cmdlet programu PowerShell zapoznaj się z dodatkowymi artykułami:

Programowanie dla usługi IoT Hub:

Poznaj możliwości usługi IoT Hub: