Add-AzIotHubDevice
IoT Hub에서 디바이스를 만듭니다.
Syntax
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 Hub에서 다른 권한 부여 유형을 가진 디바이스를 만듭니다.
예제
예 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
엔터티를 만들 권한 부여 유형입니다.
Type: | PSDeviceAuthType |
Accepted values: | shared_private_key, x509_thumbprint, x509_ca |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Children
자식 디바이스 목록 추가(쉼표로 구분됨)에는 에지 이외의 디바이스만 포함됩니다.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeviceId
대상 디바이스 ID입니다.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EdgeEnabled
에지 사용 설정을 나타내는 플래그입니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
에지 이외의 디바이스의 부모 디바이스를 덮어씁니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
IotHub 개체
Type: | PSIotHub |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IotHubName
IoT Hub의 이름
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ParentDeviceId
에지 디바이스의 ID입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrimaryThumbprint
기본 키에 사용할 명시적 자체 서명된 인증서 지문입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
리소스 그룹의 이름
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceId
IotHub 리소스 ID
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SecondaryThumbprint
보조 키에 사용할 명시적 자체 서명된 인증서 지문입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Status
만들 때 디바이스 상태 설정합니다.
Type: | PSDeviceStatus |
Accepted values: | Enabled, Disabled |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StatusReason
디바이스 상태 대한 설명입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
입력
출력
Azure PowerShell
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기