Set-AzIotHubDevice

模組:: Az.IotHub Module

更新一個 IoT 中樞裝置。

語法

ResourceSetForStatus (預設值)

Set-AzIotHubDevice
    [-ResourceGroupName] <String>
    [-IotHubName] <String>
    [-DeviceId] <String>
    [-Status <PSDeviceStatus>]
    [-StatusReason <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectSetForAuth

Set-AzIotHubDevice
    [-InputObject] <PSIotHub>
    [-DeviceId] <String>
    [-AuthMethod <PSDeviceAuthType>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectSetForStatus

Set-AzIotHubDevice
    [-InputObject] <PSIotHub>
    [-DeviceId] <String>
    [-Status <PSDeviceStatus>]
    [-StatusReason <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectSetForEdgeEnabled

Set-AzIotHubDevice
    [-InputObject] <PSIotHub>
    [-DeviceId] <String>
    [-EdgeEnabled <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceSetForAuth

Set-AzIotHubDevice
    [-ResourceGroupName] <String>
    [-IotHubName] <String>
    [-DeviceId] <String>
    [-AuthMethod <PSDeviceAuthType>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceSetForEdgeEnabled

Set-AzIotHubDevice
    [-ResourceGroupName] <String>
    [-IotHubName] <String>
    [-DeviceId] <String>
    [-EdgeEnabled <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdSetForAuth

Set-AzIotHubDevice
    [-ResourceId] <String>
    [-DeviceId] <String>
    [-AuthMethod <PSDeviceAuthType>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdSetForStatus

Set-AzIotHubDevice
    [-ResourceId] <String>
    [-DeviceId] <String>
    [-Status <PSDeviceStatus>]
    [-StatusReason <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdSetForEdgeEnabled

Set-AzIotHubDevice
    [-ResourceId] <String>
    [-DeviceId] <String>
    [-EdgeEnabled <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

更新一個 IoT 中樞裝置。

範例

範例 1

Set-AzIotHubDevice -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -EdgeEnabled $true

開啟裝置的邊緣功能。

範例 2

Set-AzIotHubDevice -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -Status Disabled

停用裝置狀態。

範例 3

Set-AzIotHubDevice -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -AuthMethod "x509_ca"

更新 Iot Hub 裝置的授權類型。

參數

-AuthMethod

要用來建立實體的授權類型。

參數屬性

類型:	PSDeviceAuthType
預設值:	None
接受的值:	shared_private_key, x509_thumbprint, x509_ca
支援萬用字元:	False
不要顯示:	False

參數集

InputObjectSetForAuth

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

ResourceSetForAuth

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

ResourceIdSetForAuth

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

指出邊緣啟用的旗標。

參數屬性

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

參數集

InputObjectSetForEdgeEnabled

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

ResourceSetForEdgeEnabled

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

ResourceIdSetForEdgeEnabled

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

-InputObject

IotHub 物件

參數屬性

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

參數集

InputObjectSetForAuth

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

InputObjectSetForStatus

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

InputObjectSetForEdgeEnabled

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

-IotHubName

IoT 中樞的名稱

參數屬性

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

參數集

ResourceSetForStatus

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

ResourceSetForAuth

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

ResourceSetForEdgeEnabled

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

-PrimaryThumbprint

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

參數屬性

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

參數集

InputObjectSetForAuth

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

ResourceSetForAuth

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

ResourceIdSetForAuth

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

-ResourceGroupName

資源群組的名稱

參數屬性

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

參數集

ResourceSetForStatus

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

ResourceSetForAuth

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

ResourceSetForEdgeEnabled

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

-ResourceId

IotHub 資源識別碼

參數屬性

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

參數集

ResourceIdSetForAuth

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

ResourceIdSetForStatus

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

ResourceIdSetForEdgeEnabled

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

-SecondaryThumbprint

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

參數屬性

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

參數集

InputObjectSetForAuth

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

ResourceSetForAuth

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

ResourceIdSetForAuth

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

-Status

在建立時設定裝置狀態。

參數屬性

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

參數集

ResourceSetForStatus

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

InputObjectSetForStatus

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

ResourceIdSetForStatus

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

-StatusReason

裝置狀態的描述。

參數屬性

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

參數集

ResourceSetForStatus

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

InputObjectSetForStatus

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

ResourceIdSetForStatus

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。

Set-AzIotHubDevice

語法

ResourceSetForStatus (預設值)

InputObjectSetForAuth

InputObjectSetForStatus

InputObjectSetForEdgeEnabled

ResourceSetForAuth

ResourceSetForEdgeEnabled

ResourceIdSetForAuth

ResourceIdSetForStatus

ResourceIdSetForEdgeEnabled

Description

範例

範例 1

範例 2

範例 3

參數

-AuthMethod

參數屬性

參數集

-Confirm

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-DeviceId

參數屬性

參數集

-EdgeEnabled

參數屬性

參數集

-InputObject

參數屬性

參數集

-IotHubName

參數屬性

參數集

-PrimaryThumbprint

參數屬性

參數集

-ResourceGroupName

參數屬性

參數集

-ResourceId

參數屬性

參數集

-SecondaryThumbprint

參數屬性

參數集

-Status

參數屬性

參數集

-StatusReason

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

輸入

PSIotHub

String

輸出

PSDevice

意見反應