Update-AzKeyVaultSecret

Uppdaterar attribut för en hemlighet i ett nyckelvalv.

Syntax

Default (Standard)

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>]

InputObject

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

Description

Cmdleten Update-AzKeyVaultSecret uppdaterar redigerbara attribut för en hemlighet i ett nyckelvalv.

Exempel

Exempel 1: Ändra attributen för en hemlighet

$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

De första fyra kommandona definierar attribut för förfallodatumet, datum, taggar och kontexttyp för NotBefore och lagrar attributen i variabler. Det sista kommandot ändrar attributen för hemligheten med namnet HR i nyckelvalvet med namnet ContosoVault med hjälp av de lagrade variablerna.

Exempel 2: Ta bort taggarna och innehållstypen för en hemlighet

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

Det här kommandot tar bort taggarna och innehållstypen för den angivna versionen av hemligheten med namnet HR i nyckelvalvet med namnet Contoso.

Exempel 3: Inaktivera den aktuella versionen av hemligheter vars namn börjar med IT

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

Det första kommandot lagrar strängvärdet Contoso i variabeln $Vault. Det andra kommandot lagrar strängvärdet IT i variabeln $Prefix. Det tredje kommandot använder cmdleten Get-AzKeyVaultSecret för att hämta hemligheterna i det angivna nyckelvalvet och skickar sedan dessa hemligheter till cmdleten Where-Object . Cmdleten Where-Object filtrerar hemligheterna efter namn som börjar med tecknen IT. Kommandot dirigerar hemligheterna som matchar filtret med cmdleten Update-AzKeyVaultSecret, vilket inaktiverar dem.

Exempel 4: Ange ContentType för alla versioner av en hemlighet

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

De första tre kommandona definierar strängvariabler som ska användas för parametrarna VaultName, Name och ContentType . Det fjärde kommandot använder cmdleten Get-AzKeyVaultKey för att hämta de angivna nycklarna och dirigerar nycklarna till cmdleten Update-AzKeyVaultSecret för att ange deras innehållstyp till XML.

Exempel 5: Ta bort taggarna och innehållstypen för en hemlighet (med hjälp av URI)

Update-AzKeyVaultSecret -Id 'https://ContosoVault.vault.azure.net:443/secrets/HR/9EEA45C6EE50490B9C3176A80AC1A0DF'  -ContentType '' -Tag @{}

Det här kommandot tar bort taggarna och innehållstypen för den angivna versionen av hemligheten med namnet HR i nyckelvalvet med namnet Contoso.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ContentType

Hemlighetens innehållstyp. Om det inte anges förblir det befintliga värdet för hemlighetens innehållstyp oförändrat. Ta bort det befintliga innehållstypsvärdet genom att ange en tom sträng.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Enable

Om det finns aktiverar du en hemlighet om värdet är sant. Inaktivera en hemlighet om värdet är falskt. Om det inte anges förblir det befintliga värdet för hemlighetens aktiverade/inaktiverade tillstånd oförändrat.

Parameteregenskaper

Typ:

Nullable<T>[Boolean]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Expires

Förfallotiden för en hemlighet i UTC-tid. Om det inte anges förblir det befintliga värdet för hemlighetens förfallotid oförändrat.

Parameteregenskaper

Typ:

Nullable<T>[DateTime]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Id

URI:n för KeyVault-hemligheten. Se till att det följer formatet:

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:SecretId

Parameteruppsättningar

BySecretUri
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-InputObject

Hemligt objekt

Parameteregenskaper

Typ:PSKeyVaultSecretIdentityItem
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

InputObject
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

Hemligt namn. Cmdlet konstruerar FQDN för en hemlighet från valvnamnet, som för närvarande är valt miljö och hemligt namn.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:SecretName

Parameteruppsättningar

Default
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-NotBefore

UTC-tiden innan hemligheten inte kan användas. Om det inte anges förblir det befintliga värdet för hemlighetens NotBefore-attribut oförändrat.

Parameteregenskaper

Typ:

Nullable<T>[DateTime]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PassThru

Cmdlet returnerar inte objekt som standard. Om den här växeln har angetts returnerar du Hemligt objekt.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Tag

En hashtable som representerar hemliga taggar. Om det inte anges förblir de befintliga taggarna för hemligheten oförändrade. Ta bort en tagg genom att ange en tom Hashtable.

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Etiketter

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-VaultName

Valvnamn. Cmdleten konstruerar FQDN för ett valv baserat på namnet och den aktuella miljön.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Default
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Version

Hemlig version. Cmdlet konstruerar FQDN för en hemlighet från valvnamn, för närvarande vald miljö, hemligt namn och hemlig version.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:SecretVersion

Parameteruppsättningar

(All)
Position:2
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSKeyVaultSecretIdentityItem

Utdata

PSKeyVaultSecret