使用 New-AzIotHub cmdlet 创建 IoT 中心Create an IoT hub using the New-AzIotHub cmdlet

介绍Introduction

可以使用 Azure PowerShell cmdlet 创建和管理 Azure IoT 中心。You can use Azure PowerShell cmdlets to create and manage Azure IoT hubs. 本教程介绍如何使用 PowerShell 创建 IoT 中心。This tutorial shows you how to create an IoT hub with PowerShell.

若要完成本操作说明,需要 Azure 订阅。To complete this how-to, you need an Azure subscription. 如果没有 Azure 订阅,可在开始前创建一个 试用帐户If you don't have an Azure subscription, create a trial account before you begin.

备注

本文进行了更新,以便使用新的 Azure PowerShell Az 模块。This article has been updated to use the new Azure PowerShell Az module. 你仍然可以使用 AzureRM 模块,至少在 2020 年 12 月之前,它将继续接收 bug 修补程序。You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. 若要详细了解新的 Az 模块和 AzureRM 兼容性,请参阅新 Azure Powershell Az 模块简介To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. 有关 Az 模块安装说明,请参阅安装 Azure PowerShellFor Az module installation instructions, see Install Azure PowerShell.

连接到 Azure 订阅Connect to your Azure subscription

如果改为在本地运行 PowerShell,请输入以下命令以登录 Azure 订阅:If you are running PowerShell locally instead, enter the following command to sign in to your Azure subscription:

# Log into Azure account.
Login-AzAccount -Environment AzureChinaCloud

创建资源组Create a resource group

需要一个资源组来部署 IoT 中心。You need a resource group to deploy an IoT hub. 可以使用现有资源组,也可以创建新组。You can use an existing resource group or create a new one.

若要为 IoT 中心创建资源组,请使用 New-AzResourceGroup 命令。To create a resource group for your IoT hub, use the New-AzResourceGroup command. 此示例在“中国东部” 区域中创建名为 MyIoTRG1 的资源组:This example creates a resource group called MyIoTRG1 in the China East region:

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

创建 IoT 中心Create an IoT hub

若要在上一步创建的资源组中创建 IoT 中心,请使用 New-AzIotHub 命令。To create an IoT hub in the resource group you created in the previous step, use the New-AzIotHub command. 此示例在“中国东部” 区域中创建名为 MyTestIoTHubS1 中心:This example creates an S1 hub called MyTestIoTHub in the China East region:

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

IoT 中心的名称必须是全局唯一的。The name of the IoT hub must be globally unique.

重要

IoT 中心将公开为 DNS 终结点,因此,命名时请务必避免包含任何敏感信息。The IoT hub will be publicly discoverable as a DNS endpoint, so make sure to avoid any sensitive information while naming it.

可以使用 Get-AzIotHub 命令列出订阅中的所有 IoT 中心:You can list all the IoT hubs in your subscription using the Get-AzIotHub command:

Get-AzIotHub

此示例显示在上一步中创建的 S1 标准 IoT 中心。This example shows the S1 Standard IoT Hub you created in the previous step.

可以使用 Remove-AzIotHub 命令删除 IoT 中心:You can delete the IoT hub using the Remove-AzIotHub command:

Remove-AzIotHub `
    -ResourceGroupName MyIoTRG1 `
    -Name MyTestIoTHub

或者,可以使用 Remove-AzResourceGroup 命令删除资源组及其包含的所有资源:Alternatively, you can remove a resource group and all the resources it contains using the Remove-AzResourceGroup command:

Remove-AzResourceGroup -Name MyIoTRG1

后续步骤Next steps

现在,已使用 PowerShell cmdlet 部署了 IoT 中心,如果想要进一步探索,请查看以下文章:Now you have deployed an IoT hub using a PowerShell cmdlet, if you want to explore further, check out the following articles:

若要详细了解如何开发 IoT 中心,请参阅以下文章:To learn more about developing for IoT Hub, see the following articles:

若要进一步探索 IoT 中心的功能,请参阅:To further explore the capabilities of IoT Hub, see: