共用方式為

Update-AzKeyVaultSetting

  • 參考
模組:
Az.KeyVault

更新與受控 HSM 相關聯的特定設定。

語法

Update-AzKeyVaultSetting
      [-HsmName] <String>
      [-Name] <String>
      [-Value] <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzKeyVaultSetting
      [[-HsmName] <String>]
      [[-Value] <String>]
      [-InputObject] <PSKeyVaultSetting>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzKeyVaultSetting
      [-Name] <String>
      [-Value] <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-HsmObject] <PSManagedHsm>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzKeyVaultSetting
      [-Name] <String>
      [-Value] <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-HsmId] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update-AzKeyVaultSetting Cmdlet 會更新密鑰保存庫帳戶設定。 此 Cmdlet 會更新特定的金鑰保存庫帳戶設定。

範例

範例 1：更新特定的金鑰保存庫帳戶設定

Update-AzKeyVaultSetting -HsmName testmhsm -Name AllowKeyManagementOperationsThroughARM -Value true -PassThru

Name                                   Value Type    HSM Name
----                                   ----- ----    --------
AllowKeyManagementOperationsThroughARM true  boolean testmhsm

更新受控 Hsm 中名為 AllowKeyManagementOperationsThroughARM testmhsm的特定金鑰保存庫帳戶設定。

範例 2：更新與另一個帳戶設定相同的特定密鑰保存庫帳戶設定

$setting = Get-AzKeyVaultSetting -HsmName testmhsm1 -Name AllowKeyManagementOperationsThroughARM
$setting | Update-AzKeyVaultSetting -HsmName testmhsm2 -PassThru

Name                                   Value Type    HSM Name
----                                   ----- ----    --------
AllowKeyManagementOperationsThroughARM true  boolean testmhsm2

使用更新受控 Hsm 中名為 AllowKeyManagementOperationsThroughARM testmhsm2 testmhsm1的特定金鑰保存庫帳戶設定。

範例 3：透過 HsmObject 更新特定金鑰保存庫帳戶設定

$hsmObject = Get-AzKeyVaultManagedHsm -Name testmhsm
Update-AzKeyVaultSetting -HsmObject $hsmObject -Name AllowKeyManagementOperationsThroughARM -Value true -PassThru

Name                                   Value Type    HSM Name
----                                   ----- ----    --------
AllowKeyManagementOperationsThroughARM true  boolean testmhsm

透過 HsmObject 更新受控 Hsm 中名為 AllowKeyManagementOperationsThroughARM testmhsm 的特定密鑰保存庫帳戶設定。

範例 4：透過 HsmId 更新特定的金鑰保存庫帳戶設定

$hsmObject = Get-AzKeyVaultManagedHsm -Name testmhsm
Update-AzKeyVaultSetting -HsmId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/test-rg/providers/Microsoft.KeyVault/managedHSMs/testmhsm-Name AllowKeyManagementOperationsThroughARM -Value true -PassThru

Name                                   Value Type    HSM Name
----                                   ----- ----    --------
AllowKeyManagementOperationsThroughARM true  boolean testmhsm

透過 HsmObject 更新受控 Hsm 中名為 AllowKeyManagementOperationsThroughARM testmhsm 的特定密鑰保存庫帳戶設定。

參數

-Confirm

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

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

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

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-HsmId

Hsm 資源標識碼。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-HsmName

HSM 的名稱。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-HsmObject

Hsm 物件。

類型:PSManagedHsm
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-InputObject

已刪除保存庫的位置。

類型:PSKeyVaultSetting
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

設定的名稱。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-PassThru

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

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Value

設定的值。

類型:String
Position:2
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-WhatIf

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

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

PSKeyVaultSetting

PSManagedHsm

輸出

PSKeyVaultSetting