Add-AzIotHubCertificate

參考

模組:: Az.IotHub

建立/更新 Azure IoT 中樞憑證。

Syntax

Add-AzIotHubCertificate
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-CertificateName] <String>
   [-Path] <String>
   [-Etag <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzIotHubCertificate
   [-InputObject] <PSCertificateDescription>
   [-Path] <String>
   [-Etag <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzIotHubCertificate
   [-ResourceId] <String>
   [-Path] <String>
   [-Etag <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

上傳新的憑證，或以相同名稱取代現有的憑證。如需 Azure IoT 中樞 CA 憑證的詳細說明，請參閱https://learn.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview

範例

範例 1

Add-AzIotHubCertificate -ResourceGroupName "myresourcegroup" -Name "myiothub" -CertificateName "mycertificate" -Path "c:\mycertificate.cer"

Id					: /subscriptions/377cxxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Microsoft.Devices/IotHubs/myiothub/certificates/mycertificate
ResourceGroupName	: myresourcegroup
Name				: myiothub
CertificateName		: mycertificate
Subject				: CN=mycertificate
Thumbprint			: 38303FC7371EC78DDE3E18D712C8414EE50969C7
Status				: Unverified
Expiry				: 1/01/2027 16:01
Created				: 1/01/2017 16:01
Etag				: AAAAAAFpGcA=

將 CA 憑證 CER 檔案上傳至 IoT 中樞。

範例 2

Add-AzIotHubCertificate -ResourceGroupName "myresourcegroup" -Name "myiothub" -CertificateName "mycertificate" -Path "c:\mycertificate.cer" -Etag "AAAAAAFPazE="

Id					: /subscriptions/377cxxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Microsoft.Devices/IotHubs/myiothub/certificates/mycertificate
ResourceGroupName	: myresourcegroup
Name				: myiothub
CertificateName		: mycertificate
Subject				: CN=mycertificate
Thumbprint			: 38303FC7371EC13DDE3E18D712C8414EE50969C7
Status				: Unverified
Expiry				: 1/01/2027 16:01
Created				: 1/01/2017 16:01
Etag				: AAAAAAFpObE=

更新 IoT 中樞中的 CA 憑證，方法是上傳新的 CER 檔案。

參數

-CertificateName

憑證的名稱

類型:	String
Position:	2
預設值:	None
必要:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
Aliases:	cf
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

類型:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Etag

憑證的 Etag

類型:	String
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Certificate 物件

類型:	PSCertificateDescription
Position:	0
預設值:	None
必要:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

IoT 中樞的名稱

類型:	String
Position:	1
預設值:	None
必要:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

x509 憑證的base-64表示法.cer檔案或 .pem 檔案路徑。

類型:	String
Position:	1
預設值:	None
必要:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

資源群組的名稱

類型:	String
Position:	0
預設值:	None
必要:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceId

憑證資源標識碼

類型:	String
Position:	0
預設值:	None
必要:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

類型:	SwitchParameter
Aliases:	wi
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

PSCertificateDescription

String

輸出