Add-AzIotHubDevice

參考

模組:: Az.IotHub

在 IoT 中樞中建立裝置。

語法

Add-AzIotHubDevice
   [-ResourceGroupName] <String>
   [-IotHubName] <String>
   [-DeviceId] <String>
   [-AuthMethod <PSDeviceAuthType>]
   [-Status <PSDeviceStatus>]
   [-StatusReason <String>]
   [-EdgeEnabled]
   [-Children <String[]>]
   [-ParentDeviceId <String>]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzIotHubDevice
   [-InputObject] <PSIotHub>
   [-DeviceId] <String>
   [-AuthMethod <PSDeviceAuthType>]
   [-Status <PSDeviceStatus>]
   [-StatusReason <String>]
   [-EdgeEnabled]
   [-Children <String[]>]
   [-ParentDeviceId <String>]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzIotHubDevice
   [-ResourceId] <String>
   [-DeviceId] <String>
   [-AuthMethod <PSDeviceAuthType>]
   [-Status <PSDeviceStatus>]
   [-StatusReason <String>]
   [-EdgeEnabled]
   [-Children <String[]>]
   [-ParentDeviceId <String>]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

在IoT中樞中建立具有不同授權類型的裝置。

範例

範例 1

Add-AzIotHubDevice -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -AuthMethod "shared_private_key" -EdgeEnabled

使用預設授權建立已啟用邊緣的IoT裝置（共用私鑰）。

範例 2

Add-AzIotHubDevice -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice2" -AuthMethod "x509_ca" -Status Disabled -StatusReason "Some Reason"

建立具有已停用狀態和原因之根 CA 授權的 IoT 裝置。

範例 3

Add-AzIotHubDevice -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -AuthMethod "shared_private_key" -EdgeEnabled -Children device1,device2

建立已啟用邊緣的IoT裝置，並將子裝置新增至其中。

範例 4

Add-AzIotHubDevice -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -AuthMethod "shared_private_key" -ParentDeviceId parentDevice1

建立IoT裝置並設定其父裝置。

參數

-AuthMethod

要建立實體的授權類型。

類型:	PSDeviceAuthType
接受的值:	shared_private_key, x509_thumbprint, x509_ca
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Children

新增子裝置清單（以逗號分隔）僅包含非邊緣裝置。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DeviceId

目標裝置標識碼。

類型:	String
Position:	1
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-EdgeEnabled

指出邊緣啟用的旗標。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

覆寫非邊緣裝置的父裝置。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

IotHub 物件

類型:	PSIotHub
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-IotHubName

IoT 中樞的名稱

類型:	String
Position:	1
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ParentDeviceId

邊緣裝置的標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PrimaryThumbprint

要用於主鍵的明確自我簽署憑證指紋。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源群組的名稱

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ResourceId

IotHub 資源標識碼

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-SecondaryThumbprint

要用於次要密鑰的明確自我簽署憑證指紋。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Status

在建立時設定裝置狀態。

類型:	PSDeviceStatus
接受的值:	Enabled, Disabled
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-StatusReason

裝置狀態的描述。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

PSIotHub

String

輸出

PSDevice

共用方式為