Update-AzureKeyVaultSecret
Anahtar kasasında gizli dizi özniteliklerini Güncelleştirmeler.
Uyarı
AzureRM PowerShell modülü 29 Şubat 2024 itibarıyla resmi olarak kullanım dışı bırakılmıştır. Kullanıcıların destek ve güncelleştirmelerin devam etmesini sağlamak için AzureRM'den Az PowerShell modülüne geçmeleri tavsiye edilir.
AzureRM modülü çalışmaya devam edebilir, ancak artık bakım yapılmaz veya desteklenmez ve kullanıcının takdirine ve riskine bağlı olarak sürekli kullanım sağlanır. Az modülüne geçiş konusunda yönergeler için lütfen geçiş kaynaklarımıza bakın.
Syntax
Update-AzureKeyVaultSecret
[-VaultName] <String>
[-Name] <String>
[[-Version] <String>]
[-Enable <Boolean>]
[-Expires <DateTime>]
[-NotBefore <DateTime>]
[-ContentType <String>]
[-Tag <Hashtable>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzureKeyVaultSecret
[-InputObject] <PSKeyVaultSecretIdentityItem>
[[-Version] <String>]
[-Enable <Boolean>]
[-Expires <DateTime>]
[-NotBefore <DateTime>]
[-ContentType <String>]
[-Tag <Hashtable>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Update-AzureKeyVaultSecret cmdlet'i, anahtar kasasında bir gizli dizinin düzenlenebilir özniteliklerini güncelleştirir.
Örnekler
Örnek 1: Gizli dizinin özniteliklerini değiştirme
PS C:\> $Expires = (Get-Date).AddYears(2).ToUniversalTime()
PS C:\> $Nbf = (Get-Date).ToUniversalTime()
PS C:\> $Tags = @{ 'Severity' = 'medium'; 'HR' = 'true'}
PS C:\> $ContentType= 'xml'
PS C:\> Update-AzureKeyVaultSecret -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
İlk dört komut, bitiş tarihi, NotBefore tarihi, etiketler ve bağlam türü için öznitelikleri tanımlar ve öznitelikleri değişkenlerde depolar. Son komut, depolanan değişkenleri kullanarak ContosoVault adlı anahtar kasasında İk adlı gizli diziye ilişkin öznitelikleri değiştirir.
Örnek 2: Gizli dizi için etiketleri ve içerik türünü silme
PS C:\> Update-AzureKeyVaultSecret -VaultName 'ContosoVault' -Name 'HR' -Version '9EEA45C6EE50490B9C3176A80AC1A0DF' -ContentType '' -Tag -@{}
Bu komut, Contoso adlı anahtar kasasında İk adlı gizli dizinin belirtilen sürümü için etiketleri ve içerik türünü siler.
Örnek 3: Adı BT ile başlayan gizli dizilerin geçerli sürümünü devre dışı bırakma
PS C:\> $Vault = 'ContosoVault'
PS C:\> $Prefix = 'IT'
PS C:\> Get-AzureKeyVaultSecret $Vault | Where-Object {$_.Name -like $Prefix + '*'} | Update-AzureKeyVaultSecret -Enable $False
İlk komut Contoso dize değerini $Vault değişkeninde depolar. İkinci komut, BT dize değerini $Prefix değişkeninde depolar. Üçüncü komut, belirtilen anahtar kasasındaki gizli dizileri almak için Get-AzureKeyVaultSecret cmdlet'ini kullanır ve ardından bu gizli dizileri Where-Object cmdlet'ine geçirir. Where-Object cmdlet'i, BT karakterleriyle başlayan adların gizli dizilerini filtreler. komutu, filtreyle eşleşen gizli dizileri Update-AzureKeyVaultSecret cmdlet'ine aktarır ve bu da bunları devre dışı bırakır.
Örnek 4: Gizli dizinin tüm sürümleri için ContentType değerini ayarlama
PS C:\> $VaultName = 'ContosoVault'
PS C:\> $Name = 'HR'
PS C:\> $ContentType = 'xml'
PS C:\> Get-AzureKeyVaultKey -VaultName $VaultName -Name $Name -IncludeVersions | Update-AzureKeyVaultSecret -ContentType $ContentType
İlk üç komut VaultName, Name ve ContentType parametreleri için kullanılacak dize değişkenlerini tanımlar. Dördüncü komut, belirtilen anahtarları almak için Get-AzureKeyVaultKey cmdlet'ini kullanır ve içerik türlerini XML olarak ayarlamak için anahtarları Update-AzureKeyVaultSecret cmdlet'ine aktarır.
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContentType
Gizli dizinin içerik türü. Belirtilmezse, gizli dizinin içerik türünün mevcut değeri değişmeden kalır. Boş bir dize belirterek mevcut içerik türü değerini kaldırın.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enable
Varsa, değer doğruysa gizli diziyi etkinleştirin. Değer false ise gizli diziyi devre dışı bırakın. Belirtilmezse, gizli dizinin etkin/devre dışı durumunun mevcut değeri değişmeden kalır.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Expires
Utc saatinde gizli dizinin sona erme zamanı. Belirtilmezse, gizli dizinin süre sonu süresinin mevcut değeri değişmeden kalır.
Type: | Nullable<T>[DateTime] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Gizli dizi nesnesi
Type: | PSKeyVaultSecretIdentityItem |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Gizli dizi adı. Cmdlet, kasa adından, seçili durumdaki ortamdan ve gizli dizi adından bir gizli dizinin FQDN'sini oluşturur.
Type: | String |
Aliases: | SecretName |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NotBefore
Önceki gizli dizinin kullanılamadığı UTC saati. Belirtilmezse, gizli dizinin NotBefore özniteliğinin mevcut değeri değişmeden kalır.
Type: | Nullable<T>[DateTime] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Cmdlet varsayılan olarak nesne döndürmez. Bu anahtar belirtilirse Gizli dizi nesnesini döndür.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Gizli dizi etiketlerini temsil eden bir karma tablo. Belirtilmezse, gizli dizinin mevcut etiketleri değişmeden kalır. Boş bir Hashtable belirterek etiketi kaldırın.
Type: | Hashtable |
Aliases: | Tags |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VaultName
Kasa adı. Cmdlet, bir kasanın FQDN'sini ada ve o anda seçili olan ortama göre oluşturur.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Version
Gizli dizi sürümü. Cmdlet, kasa adından, şu anda seçili ortamdan, gizli dizi adından ve gizli dizi sürümünden bir gizli dizinin FQDN'sini oluşturur.
Type: | String |
Aliases: | SecretVersion |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
Parametreler: InputObject (ByValue)