Update-AzureKeyVaultCertificate

參考

模組:: AzureRM.KeyVault

修改憑證的可編輯屬性。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。如需轉換至 Az 模組的指引，請參閱我們的移轉資源。

Syntax

Update-AzureKeyVaultCertificate
      [-VaultName] <String>
      [-Name] <String>
      [[-Version] <String>]
      [-Enable <Boolean>]
      [-Tag <Hashtable>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureKeyVaultCertificate
      [-InputObject] <PSKeyVaultCertificateIdentityItem>
      [[-Version] <String>]
      [-Enable <Boolean>]
      [-Tag <Hashtable>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update-AzureKeyVaultCertificate Cmdlet 會修改憑證的可編輯屬性。

範例

範例 1：修改與憑證相關聯的標記

PS C:\> $Tags = @{ "Team" = "Azure" ; "Role" = "Engg" }
PS C:\> Update-AzureKeyVaultCertificate -VaultName "ContosoKV01" -Name "TestCert01" -Tag $Tags -PassThru

Name        : TestCert01
Certificate : [Subject]
                CN=AZURE

              [Issuer]
                CN=AZURE

              [Serial Number]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

              [Not Before]
                7/27/2016 6:50:01 PM

              [Not After]
                7/27/2018 7:00:01 PM

              [Thumbprint]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Id          : https://ContosoKV01.vault.azure.net:443/certificates/TestCert01
KeyId       : https://ContosoKV01.vault.azure.net:443/keys/TestCert01
SecretId    : https://ContosoKV01.vault.azure.net:443/secrets/TestCert01
Thumbprint  : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Tags        : {[Role, Engg], [Team, Azure]}
Enabled     : True
Created     : 7/28/2016 2:00:01 AM
Updated     : 8/1/2016 5:37:48 PM

第一個命令會將索引鍵/值組的陣列指派給$Tags變數。第二個命令會將名為 TestCert01 的憑證標記值設定為$Tags。

參數

-Confirm

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

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

-DefaultProfile

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

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

-Enable

如果有，如果值為 true，請啟用憑證。如果值為 false，請停用憑證。如果未指定，憑證已啟用/停用狀態的現有值會維持不變。

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Certificate 物件

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

-Name

憑證名稱。 Cmdlet 會從保存庫名稱建構秘密的 FQDN，目前選取的環境和秘密名稱。

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

-PassThru

Cmdlet 預設不會傳回物件。如果指定此參數，則傳回憑證物件。

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

-Tag

代表憑證標記的哈希表。如果未指定，則 sertificate 的現有標記會維持不變。藉由指定空的Hashtable來移除標記。

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

-VaultName

保存庫名稱。 Cmdlet 會根據名稱和目前選取的環境來建構保存庫的 FQDN。

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

-Version

憑證版本。 Cmdlet 會從保存庫名稱、目前選取的環境、憑證名稱和憑證版本建構憑證的 FQDN。

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

-WhatIf

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

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

輸入

PSKeyVaultCertificateIdentityItem

參數：InputObject （ByValue）

輸出

PSKeyVaultCertificate

共用方式為