Set-SecretInfo

Módulo:

Microsoft.PowerShell.SecretManagement

Adiciona ou substitui metadados secretos adicionais a um segredo armazenado atualmente em um cofre.

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

Esse cmdlet adiciona informações adicionais de metadados a um segredo armazenado. O suporte a metadados é um recurso opcional para um cofre de extensão. Se um cofre não der suporte a metadados secretos, o cmdlet retornará um erro.

Os metadados não são armazenados com segurança em um cofre. Os metadados não devem conter informações confidenciais.

Exemplos

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

Este exemplo adiciona metadados ao Secret1 segredo armazenado no Vault1 cofre. Get-SecretInfo recupera os metadados de para Secret1 mostrar os metadados adicionados.

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

Este exemplo adiciona metadados ao Secret2 segredo armazenado no Vault2 cofre. No entanto, Vault2 não dá suporte a metadados. O comando falha e retorna um erro.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-Metadata

Especifica uma tabela de hash que contém pares chave-valor a serem associados ao segredo no cofre. O cofre de extensão especificado pode não dar suporte a metadados secretos. Se o cofre não der suporte a metadados, a operação falhará e retornará um erro. Os valores de quaisquer metadados na tabela de hash devem ser um dos seguintes tipos:

• cadeia de caracteres
• int
• DateTime

Os metadados não são armazenados com segurança em um cofre. Os metadados não devem conter informações confidenciais.

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

-Name

Especifica o nome do segredo ao qual adicionar metadados. Caracteres curinga (*) não são permitidos.

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

-NoClobber

Indica que o comando deve ocorrer um erro se já existir um segredo com o mesmo nome no cofre. Por padrão, esse cmdlet atualiza o segredo com o novo valor se ele já existir.

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

-Secret

Especifica o valor do segredo. O tipo de objeto deve ser um dos tipos com suporte:

• Byte[]
• Cadeia de caracteres
• SecureString
• PSCredential
• Hashtable

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

-SecretInfo

Especifica um objeto SecretInformation que descreve um segredo armazenado retornado por Get-SecretInfo. Isso permite copiar segredos de um cofre de extensão para outro.

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

-SecureStringSecret

Especifica o valor do segredo como um objeto SecretString .

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

-Vault

Especifica o nome do cofre que contém o segredo para o qual adicionar ou atualizar os metadados. Caracteres curinga (*) não são permitidos. Por padrão, esse cmdlet procura o segredo no cofre padrão do usuário atual.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Hashtable

Saídas

None