Update-AzKeyVaultSecret

構文

Update-AzKeyVaultSecret
      [-VaultName] <String>
      [-Name] <String>
      [[-Version] <String>]
      [-Enable <Boolean>]
      [-Expires <DateTime>]
      [-NotBefore <DateTime>]
      [-ContentType <String>]
      [-Tag <Hashtable>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzKeyVaultSecret
      [-InputObject] <PSKeyVaultSecretIdentityItem>
      [[-Version] <String>]
      [-Enable <Boolean>]
      [-Expires <DateTime>]
      [-NotBefore <DateTime>]
      [-ContentType <String>]
      [-Tag <Hashtable>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Update-AzKeyVaultSecret コマンドレットは、キー コンテナー内のシークレットの編集可能な属性を更新します。

例

例 1: シークレットの属性を変更する

$Expires = (Get-Date).AddYears(2).ToUniversalTime()
$Nbf = (Get-Date).ToUniversalTime()
$Tags = @{ 'Severity' = 'medium'; 'HR' = 'true'}
$ContentType= 'xml'
Update-AzKeyVaultSecret -VaultName 'ContosoVault' -Name 'HR' -Expires $Expires -NotBefore $Nbf -ContentType $ContentType -Enable $True -Tag $Tags -PassThru

Vault Name   : ContosoVault
Name         : HR
Version      : d476edfcd3544017a03bc49c1f3abec0
Id           : https://ContosoVault.vault.azure.net:443/secrets/HR/d476edfcd3544017a03bc49c1f3abec0
Enabled      : True
Expires      : 5/25/2020 8:01:58 PM
Not Before   : 5/25/2018 8:02:02 PM
Created      : 4/11/2018 11:45:06 PM
Updated      : 5/25/2018 8:02:45 PM
Content Type : xml
Tags         : Name      Value
               Severity  medium
               HR        true

最初の 4 つのコマンドでは、有効期限、NotBefore 日付、タグ、コンテキスト型の属性を定義し、属性を変数に格納します。 最後のコマンドは、格納されている変数を使用して、ContosoVault という名前のキー コンテナー内の HR という名前のシークレットの属性を変更します。

例 2: シークレットのタグとコンテンツ タイプを削除する

Update-AzKeyVaultSecret -VaultName 'ContosoVault' -Name 'HR' -Version '9EEA45C6EE50490B9C3176A80AC1A0DF' -ContentType '' -Tag @{}

このコマンドは、Contoso という名前のキー コンテナー内の HR という名前のシークレットの指定されたバージョンのタグとコンテンツ タイプを削除します。

例 3: 名前が IT で始まるシークレットの現在のバージョンを無効にする

$Vault = 'ContosoVault'
$Prefix = 'IT'
Get-AzKeyVaultSecret $Vault | Where-Object {$_.Name -like $Prefix + '*'} | Update-AzKeyVaultSecret -Enable $False

最初のコマンドは、文字列値 Contoso を $Vault 変数に格納します。 2 番目のコマンドは、文字列値 IT を $Prefix 変数に格納します。 3 番目のコマンドでは、Get-AzKeyVaultSecret コマンドレットを使用して指定したキー コンテナー内のシークレットを取得し、それらのシークレットを Where-Object コマンドレットに渡します。 Where-Object コマンドレットは、文字 IT で始まる名前のシークレットをフィルター処理します。 このコマンドにより、フィルターに一致するシークレットが Update-AzKeyVaultSecret コマンドレットにパイプされ、無効になります。

例 4: シークレットのすべてのバージョンの ContentType を設定する

$VaultName = 'ContosoVault'
$Name = 'HR'
$ContentType = 'xml'
Get-AzKeyVaultKey -VaultName $VaultName -Name $Name -IncludeVersions | Update-AzKeyVaultSecret -ContentType $ContentType

最初の 3 つのコマンドは、 VaultName、 Name、および ContentType パラメーターに使用する文字列変数を定義します。 4 番目のコマンドでは、Get-AzKeyVaultKey コマンドレットを使用して指定したキーを取得し、キーを Update-AzKeyVaultSecret コマンドレットにパイプしてコンテンツ タイプを XML に設定します。

パラメーター

-Confirm

-ContentType

-DefaultProfile

-Enable

-Expires

-InputObject

-Name

-NotBefore

-PassThru

-Tag

-VaultName

-Version

-WhatIf

入力

PSKeyVaultSecretIdentityItem

出力

PSKeyVaultSecret