Set-SecretInfo

Modul:

Microsoft.PowerShell.SecretManagement

Přidá nebo nahradí další metadata tajného kódu k tajnému kódu aktuálně uloženému v trezoru.

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

Tato rutina přidá do uloženého tajného kódu další informace o metadatech. Podpora metadat je volitelná funkce pro trezor rozšíření. Pokud trezor nepodporuje metadata tajných kódů, rutina vrátí chybu.

Metadata nejsou bezpečně uložena v trezoru. Metadata by neměla obsahovat citlivé informace.

Příklady

Příklad 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]}

Tento příklad přidá metadata do tajného kódu uloženého Secret1 v Vault1 trezoru. Get-SecretInfo Načte metadata pro a Secret1 zobrazí přidaná metadata.

Příklad 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.

Tento příklad přidá metadata do tajného kódu uloženého Secret2 v Vault2 trezoru. Vault2 Nepodporuje ale metadata. Příkaz selže a vrátí chybu.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Metadata

Určuje tabulku hash obsahující páry klíč-hodnota, které se přidruží k tajnému klíči v trezoru. Zadaný trezor rozšíření nemusí podporovat metadata tajných kódů. Pokud trezor nepodporuje metadata, operace selže a vrátí chybu. Hodnoty všech metadat v zatřiďovací tabulce musí být jeden z následujících typů:

• řetězec
• Int
• Datum a čas

Metadata nejsou bezpečně uložena v trezoru. Metadata by neměla obsahovat citlivé informace.

Type:	Hashtable
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Určuje název tajného kódu, do který se mají přidat metadata. Zástupné znaky (*) nejsou povoleny.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoClobber

Označuje, že příkaz by měl zobrazit chybu, pokud už v trezoru existuje tajný kód se stejným názvem. Ve výchozím nastavení tato rutina aktualizuje tajný klíč novou hodnotou, pokud už existuje.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Secret

Určuje hodnotu tajného kódu. Typ objektu musí být jedním z podporovaných typů:

• Bajt[]
• Řetězec
• Securestring
• Přihlašovací údaje PS
• Hashtable

Type:	Object
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SecretInfo

Určuje objekt SecretInformation popisující uložený tajný kód vrácený nástrojem Get-SecretInfo. To umožňuje kopírovat tajné kódy z jednoho trezoru rozšíření do jiného.

Type:	SecretInformation
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SecureStringSecret

Určuje hodnotu tajného klíče jako SecretString objektu.

Type:	SecureString
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Vault

Určuje název trezoru obsahujícího tajný kód, pro který se mají přidat nebo aktualizovat metadata. Zástupné znaky (*) nejsou povoleny. Ve výchozím nastavení tato rutina vyhledá tajný kód ve výchozím trezoru aktuálního uživatele.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

Hashtable

Výstupy

None