Set-SecretInfo

Référence

Module:: Microsoft.PowerShell.SecretManagement

Ajoute ou remplace des métadonnées de secret supplémentaires à un secret actuellement stocké dans un coffre.

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

Cette applet de commande ajoute des informations de métadonnées supplémentaires à un secret stocké. La prise en charge des métadonnées est une fonctionnalité facultative pour un coffre d’extensions. Si un coffre ne prend pas en charge les métadonnées secrètes, l’applet de commande retourne une erreur.

Les métadonnées ne sont pas stockées de manière sécurisée dans un coffre. Les métadonnées ne doivent pas contenir d’informations sensibles.

Exemples

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

Cet exemple montre comment ajouter des métadonnées au Secret1 secret stocké dans le Vault1 coffre. Get-SecretInfo récupère les métadonnées pour pour Secret1 pour afficher les métadonnées ajoutées.

Exemple 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.

Cet exemple montre comment ajouter des métadonnées au Secret2 secret stocké dans le Vault2 coffre. Toutefois, Vault2 ne prend pas en charge les métadonnées. La commande échoue et retourne une erreur.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-Metadata

Spécifie une table de hachage contenant des paires clé-valeur à associer au secret dans le coffre. Le coffre d’extensions spécifié peut ne pas prendre en charge les métadonnées secrètes. Si le coffre ne prend pas en charge les métadonnées, l’opération échoue et retourne une erreur. Les valeurs des métadonnées de la table de hachage doivent être de l’un des types suivants :

string
int
DateTime

Les métadonnées ne sont pas stockées de manière sécurisée dans un coffre. Les métadonnées ne doivent pas contenir d’informations sensibles.

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

-Name

Spécifie le nom du secret à laquelle ajouter des métadonnées. Les caractères génériques (*) ne sont pas autorisés.

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

-NoClobber

Indique que la commande doit être incorrecte si un secret portant le même nom existe déjà dans le coffre. Par défaut, cette applet de commande met à jour le secret avec la nouvelle valeur s’il existe déjà.

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

-Secret

Spécifie la valeur du secret. Le type d’objet doit être l’un des types pris en charge :

Byte[]
Chaîne
SecureString
PSCredential
Hashtable

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

-SecretInfo

Spécifie un objet SecretInformation décrivant un secret stocké retourné par Get-SecretInfo. Cela permet de copier des secrets d’un coffre d’extensions vers un autre.

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

-SecureStringSecret

Spécifie la valeur du secret en tant qu’objet SecretString .

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

-Vault

Spécifie le nom du coffre contenant le secret pour lequel ajouter ou mettre à jour les métadonnées. Les caractères génériques (*) ne sont pas autorisés. Par défaut, cette applet de commande recherche le secret dans le coffre par défaut de l’utilisateur actuel.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

Hashtable

Sorties

None

Partager via