Add-AzIotHubDevice

模組:: Az.IotHub Module

在 IoT 中樞建立一個裝置。

語法

ResourceSet (預設值)

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>]

InputObjectSet

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

ResourceIdSet

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
預設值:	None
接受的值:	shared_private_key, x509_thumbprint, x509_ca
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Children

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

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

用於與 Azure 通訊的憑證、帳號、租戶和訂閱。

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DeviceId

目標裝置標識碼。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EdgeEnabled

指出邊緣啟用的旗標。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Force

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-InputObject

IotHub 物件

參數屬性

類型:	PSIotHub
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

InputObjectSet

Position:	0
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IotHubName

IoT 中樞的名稱

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ResourceSet

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ParentDeviceId

邊緣裝置的標識碼。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PrimaryThumbprint

用於主金鑰的明確自我簽署憑證指紋。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ResourceGroupName

資源群組的名稱

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ResourceSet

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ResourceId

IotHub 資源識別碼

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ResourceIdSet

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-SecondaryThumbprint

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Status

在建立時設定裝置狀態。

參數屬性

類型:	PSDeviceStatus
預設值:	None
接受的值:	Enabled, Disabled
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-StatusReason

裝置狀態的描述。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	無線

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

Add-AzIotHubDevice

語法

ResourceSet (預設值)

InputObjectSet

ResourceIdSet

Description

範例

範例 1

範例 2

範例 3

範例 4

參數

-AuthMethod

參數屬性

參數集

-Children

參數屬性

參數集

-Confirm

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-DeviceId

參數屬性

參數集

-EdgeEnabled

參數屬性

參數集

-Force

參數屬性

參數集

-InputObject

參數屬性

參數集

-IotHubName

參數屬性

參數集

-ParentDeviceId

參數屬性

參數集

-PrimaryThumbprint

參數屬性

參數集

-ResourceGroupName

參數屬性

參數集

-ResourceId

參數屬性

參數集

-SecondaryThumbprint

參數屬性

參數集

-Status

參數屬性

參數集

-StatusReason

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

輸入

PSIotHub

String

輸出

PSDevice

意見反應