Set-SecretInfo

Modul:

Microsoft.PowerShell.SecretManagement

Lägger till eller ersätter ytterligare hemliga metadata till en hemlighet som för närvarande lagras i ett valv.

Syntax

Set-SecretInfo
   [-Name] <String>
   -SecureStringSecret <SecureString>
   [[-Vault] <String>]
   [[-Metadata] <Hashtable>]
   [-NoClobber]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SecretInfo
   [-Name] <String>
   -Secret <Object>
   [[-Vault] <String>]
   [[-Metadata] <Hashtable>]
   [-NoClobber]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SecretInfo
   -SecretInfo <SecretInformation>
   [-Vault] <String>
   [-NoClobber]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Den här cmdleten lägger till ytterligare metadatainformation till en lagrad hemlighet. Metadatastöd är en valfri funktion för ett tilläggsvalv. Om ett valv inte stöder hemliga metadata returnerar cmdleten ett fel.

Metadata lagras inte säkert i ett valv. Metadata får inte innehålla känslig information.

Exempel

Exempel 1

Set-SecretInfo -Name Secret1 -Vault Vault1 -Metadata @{ Expiration = ([datetime]::new(2022, 5, 1)) }
Get-SecretInfo -Name Secret1 -Vault Vault1 | Select-Object Name,Metadata

Name         Metadata
----         --------
Secret1 {[Expiration, 5/1/2022 12:00:00 AM]}

Det här exemplet lägger till metadata till den Secret1 hemlighet som lagras i Vault1 valv. Get-SecretInfo hämtar metadata för Secret1 för att visa de tillagda metadata.

Exempel 2

Set-SecretInfo -Name Secret2 -Vault Vault2 -Metadata @{ Expiration = ([datetime]::new(2022, 5, 1)) }

Set-SecretInfo: Cannot set secret metadata Secret2. Vault Vault2 does not support secret metadata.

Det här exemplet lägger till metadata till den Secret2 hemlighet som lagras i Vault2 valv. Men Vault2 stöder inte metadata. Kommandot misslyckas och returnerar ett fel.

Parametrar

-Confirm

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

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Metadata

Anger en Hashtable- som innehåller nyckel/värde-par som ska associeras med hemligheten i valvet. Det angivna tilläggsvalvet kanske inte stöder hemliga metadata. Om valvet inte stöder metadata misslyckas åtgärden och returnerar ett fel. Värdena för metadata i hashtabellen måste vara någon av följande typer:

• sträng
• int
• DateTime

Metadata lagras inte säkert i ett valv. Metadata får inte innehålla känslig information.

Typ:	Hashtable
Position:	1
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Name

Anger namnet på hemligheten som metadata ska läggas till i. Jokertecken (*) tillåts inte.

Typ:	String
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-NoClobber

Anger att kommandot ska fel om en hemlighet med samma namn redan finns i valvet. Som standard uppdaterar den här cmdleten hemligheten med det nya värdet om den redan finns.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Secret

Anger hemlighetens värde. Objekttypen måste vara en av de typer som stöds:

• byte[]
• String
• SecureString
• PSCredential
• Hashtable

Typ:	Object
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-SecretInfo

Anger ett SecretInformation- objekt som beskriver en lagrad hemlighet som returneras av Get-SecretInfo. På så sätt kan du kopiera hemligheter från ett tilläggsvalv till ett annat.

Typ:	SecretInformation
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-SecureStringSecret

Anger värdet för hemligheten som ett SecretString- objekt.

Typ:	SecureString
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Vault

Anger namnet på valvet som innehåller hemligheten att lägga till eller uppdatera metadata för. Jokertecken (*) tillåts inte. Som standard letar den här cmdleten efter hemligheten i den aktuella användarens standardvalv.

Typ:	String
Position:	2
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

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

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

Hashtable

Utdata

None