Update-AzKeyVaultSecret
Anahtar kasasında gizli dizi özniteliklerini güncelleştirir.
Syntax
Default (Varsayılan)
Update-AzKeyVaultSecret
[-VaultName] <String>
[-Name] <String>
[[-Version] <String>]
[-Enable <Boolean>]
[-Expires <DateTime>]
[-NotBefore <DateTime>]
[-ContentType <String>]
[-Tag <Hashtable>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
BySecretUri
Update-AzKeyVaultSecret
[-Id] <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>]
Description
Update-AzKeyVaultSecret cmdlet'i, anahtar kasasındaki bir gizli dizinin düzenlenebilir özniteliklerini güncelleştirir.
Örnekler
Örnek 1: Gizli dizinin özniteliklerini değiştirme
$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
İ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
Update-AzKeyVaultSecret -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
$Vault = 'ContosoVault'
$Prefix = 'IT'
Get-AzKeyVaultSecret $Vault | Where-Object {$_.Name -like $Prefix + '*'} | Update-AzKeyVaultSecret -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-AzKeyVaultSecret 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-AzKeyVaultSecret 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
$VaultName = 'ContosoVault'
$Name = 'HR'
$ContentType = 'xml'
Get-AzKeyVaultKey -VaultName $VaultName -Name $Name -IncludeVersions | Update-AzKeyVaultSecret -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-AzKeyVaultKey cmdlet'ini kullanır ve içerik türlerini XML olarak ayarlamak için anahtarları Update-AzKeyVaultSecret cmdlet'ine aktarır.
Örnek 5: Gizli dizi için etiketleri ve içerik türünü silme (Uri kullanarak)
Update-AzKeyVaultSecret -Id 'https://ContosoVault.vault.azure.net:443/secrets/HR/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.
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
Tür: SwitchParameter
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: Cf
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Parametre özellikleri
Tür: IAzureContextContainer
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: AzContext, AzureRmContext, AzureCredential
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: Nullable<T> [ Boolean ]
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-Id
KeyVault Gizli Dizisinin URI'si.
Lütfen şu biçime uydığından emin olun: https://<vault-name>.vault.azure.net/secrets/<secret-name>/<version>
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: SecretId
Parametre kümeleri
BySecretUri
Position: 0 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
Gizli dizi nesnesi
InputObject
Position: 0 Zorunlu: True İşlem hattından gelen değer: True Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: Gizli Dizi Adı
Parametre kümeleri
Default
Position: 1 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-NotBefore
Önceki gizli dizinin kullanılamadığı UTC saati.
Belirtilmezse, gizli dizinin NotBefore özniteliğinin mevcut değeri değişmeden kalır.
Parametre özellikleri
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-PassThru
Cmdlet varsayılan olarak nesne döndürmez.
Bu anahtar belirtilirse Gizli dizi nesnesini döndür.
Parametre özellikleri
Tür: SwitchParameter
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: Hashtable
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: Etiketler
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-VaultName
Kasa adı.
Cmdlet, bir kasanın FQDN'sini ada ve o anda seçili olan ortama göre oluşturur.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
Default
Position: 0 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: SecretVersion
Parametre kümeleri
(All)
Position: 2 Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir.
Cmdlet çalıştırılmaz.
Parametre özellikleri
Tür: SwitchParameter
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: Wi
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters .
Çıkışlar