New-AzIotHub コマンドレットを使用して IoT ハブを作成する
Azure PowerShell コマンドレットを使用すると、Azure IoT Hub を作成して管理できます。 このチュートリアルでは、PowerShell を使用して IoT Hub を作成する方法を説明します。
注意
Azure を操作するには、Azure Az PowerShell モジュールを使用することをお勧めします。 作業を開始するには、Azure PowerShell のインストールに関する記事を参照してください。 Az PowerShell モジュールに移行する方法については、「AzureRM から Az への Azure PowerShell の移行」を参照してください。
または、追加のモジュールをマシンにインストールしない場合は、Azure Cloud Shell を使用することもできます。 次のセクションでは、Azure Cloud Shell の使用を開始します。
Azure Cloud Shell
Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。 ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。
Azure Cloud Shell を開始するには、以下のようにします。
| オプション | 例とリンク |
|---|---|
| コードまたはコマンド ブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にはコピーされません。 |  |
| https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。 |  |
| Azure portal の右上にあるメニュー バーの [Cloud Shell] ボタンを選択します。 |  |
Azure Cloud Shell を使用するには、以下のようにします。
Cloud Shell を開始します。
コード ブロック (またはコマンド ブロック) の [コピー] ボタンを選択し、コードまたはコマンドをコピーします。
Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードまたはコマンドを Cloud Shell セッションに貼り付けます。
Enter キーを選択して、コードまたはコマンドを実行します。
前提条件
IoT Hub をデプロイするためのリソース グループが必要です。 既存のリソース グループを使用することも、新しいリソース グループを作成することもできます。
お使いの IoT ハブ用の新しいリソース グループを作成するには、New-AzResourceGroup コマンドを使用します。 この例では、米国東部リージョンに MyIoTRG1 というリソース グループを作成しています。
New-AzResourceGroup -Name MyIoTRG1 -Location "East US"
Azure サブスクリプションへの接続
Cloud Shell を使用している場合は、サブスクリプションにログイン済みであるため、このセクションをスキップできます。 そうではなく、PowerShell をローカルに実行している場合は、次のコマンドを入力して Azure サブスクリプションにサインインします。
# Log into Azure account.
Login-AzAccount
IoT ハブを作成する
リソース グループを使用して IoT ハブを作成します。 New-AzIotHub コマンドを使用します。 この例では、米国東部リージョンに MyTestIoTHub という S1 ハブを作成しています。
New-AzIotHub `
-ResourceGroupName MyIoTRG1 `
-Name MyTestIoTHub `
-SkuName S1 -Units 1 `
-Location "East US"
IoT ハブの名前は、グローバルに一意である必要があります。
重要
IoT ハブは DNS エンドポイントとして公開されるため、名前を付ける際に機密情報や個人を特定できる情報を入力しないように注意してください。
お使いのサブスクリプションに含まれるすべての IoT ハブを一覧表示するには、Get-AzIotHub コマンドを使用します。
この例では、前のステップで作成した S1 Standard IoT Hub を示します。
Get-AzIotHub
IoT ハブを削除するには、Remove-AzIotHub コマンドを使用します。
Remove-AzIotHub `
-ResourceGroupName MyIoTRG1 `
-Name MyTestIoTHub
IoT ハブを更新する
既存の IoT ハブは、作成後に設定を変更できます。 IoT ハブに対して設定できるプロパティの一部を以下に示します。
価格とスケール: 別のレベルに移行したり、IoT Hub ユニットの数を設定したりします。
IP フィルター:IoT Hub で許可または拒否される IP アドレスの範囲を指定します。
プロパティ: リソース ID、リソース グループ、場所など、コピーして別の場所で使用できるプロパティのリストです。
更新オプションの完全な一覧については、「Set-AzIotHub コマンド」を参照してください。
次の手順
PowerShell コマンドレットを使用して IoT ハブをデプロイしたので、さらに以下の記事を確認してください。
IoT Hub 向けの開発:
IoT Hub の機能の探索: