Update-AzureKeyVaultKey

모듈:

AzureRM.KeyVault

키 자격 증명 모음에서 키의 특성을 업데이트.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 기본 또는 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

Syntax

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

Update-AzureKeyVaultKey
      [-InputObject] <PSKeyVaultKeyIdentityItem>
      [[-Version] <String>]
      [-Enable <Boolean>]
      [-Expires <DateTime>]
      [-NotBefore <DateTime>]
      [-KeyOps <String[]>]
      [-Tag <Hashtable>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update-AzureKeyVaultKey cmdlet은 키 자격 증명 모음에 있는 키의 편집 가능한 특성을 업데이트합니다.

예제

예제 1: 키를 수정하여 사용하도록 설정하고 만료 날짜 및 태그 설정

PS C:\> $Expires = (Get-Date).AddYears(2).ToUniversalTime()
PS C:\> $Tags = @{'Severity' = 'high'; 'Accounting' = 'true'}
PS C:\> Update-AzureKeyVaultKey -VaultName 'Contoso' -Name 'ITSoftware' -Expires $Expires -Enable $True -Tag $Tags -PassThru

Vault Name     : Contoso
Name           : ITSoftware
Version        : 394f9379a47a4e2086585468de6c7ae5
Id             : https://Contoso.vault.azure.net:443/keys/ITSoftware/394f9379a47a4e2086585468de6c7ae5
Enabled        : True
Expires        : 5/25/2020 7:58:07 PM
Not Before     :
Created        : 4/6/2018 11:31:36 PM
Updated        : 5/25/2018 7:59:02 PM
Purge Disabled : False
Tags           : Name        Value
                 Severity    high
                 Accounting  true

첫 번째 명령은 Get-Date cmdlet을 사용하여 DateTime 개체를 만듭니다. 이 개체는 2년 후의 시간을 지정합니다. 명령은 해당 날짜를 $Expires 변수에 저장합니다. 자세한 내용은 다음을 입력합니다 Get-Help Get-Date. 두 번째 명령은 높은 심각도 및 Accounting의 태그 값을 저장하는 변수를 만듭니다. 마지막 명령은 ITSoftware라는 키를 수정합니다. 이 명령은 키를 사용하도록 설정하고, 만료 시간을 $Expires 저장된 시간으로 설정하고, $Tags 저장된 태그를 설정합니다.

예제 2: 모든 태그를 삭제하도록 키 수정

PS C:\> Update-AzureKeyVaultKey -VaultName 'Contoso' -Name 'ITSoftware' -Version '394f9379a47a4e2086585468de6c7ae5' -Tag @{}

Vault Name     : Contoso
Name           : ITSoftware
Version        : 394f9379a47a4e2086585468de6c7ae5
Id             : https://Contoso.vault.azure.net:443/keys/ITSoftware/394f9379a47a4e2086585468de6c7ae5
Enabled        : True
Expires        : 5/25/2020 7:58:07 PM
Not Before     :
Created        : 4/6/2018 11:31:36 PM
Updated        : 5/25/2018 8:00:08 PM
Purge Disabled : False
Tags           :

이 명령은 ITSoftware라는 키의 특정 버전에 대한 모든 태그를 삭제합니다.

매개 변수

-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

-Expires

키의 만료 시간(UTC 시간)입니다. 지정하지 않으면 키의 기존 만료 시간이 변경되지 기본.

형식:	Nullable<T>[DateTime]
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Key 개체

형식:	PSKeyVaultKeyIdentityItem
Position:	0
기본값:	None
필수:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-KeyOps

키를 사용하여 수행할 수 있는 작업입니다. 지정하지 않으면 키의 기존 키 작업이 변경되지 기본.

형식:	String[]
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

키 이름입니다. Cmdlet은 자격 증명 모음 이름, 현재 선택된 환경 및 키 이름에서 키의 FQDN을 생성합니다.

형식:	String
Aliases:	KeyName
Position:	1
기본값:	None
필수:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NotBefore

키를 사용할 수 없는 UTC 시간입니다. 지정하지 않으면 키의 기존 NotBefore 특성이 변경되지 기본.

형식:	Nullable<T>[DateTime]
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Cmdlet은 기본적으로 개체를 반환하지 않습니다. 이 스위치를 지정하면 업데이트된 키 번들 개체를 반환합니다.

형식:	SwitchParameter
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

해시 테이블은 키 태그를 나타냅니다. 지정하지 않으면 키의 기존 태그가 변경되지 기본.

형식:	Hashtable
Aliases:	Tags
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:	KeyVersion
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

입력

PSKeyVaultKeyIdentityItem

매개 변수: InputObject(ByValue)

출력

PSKeyVaultKey