Set-SecretInfo
Adiciona ou substitui metadados de segredo adicionais a um segredo armazenado atualmente em um cofre.
Sintaxe
NameParameterSet (Padrão)
Set-SecretInfo
[-Name] <String>
[-Metadata] <Hashtable>
[[-Vault] <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InfoParameterSet
Set-SecretInfo
[-Metadata] <Hashtable>
-InputObject <SecretInformation>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Esse cmdlet adiciona metadados de segredo adicionais a um segredo existente. O suporte a metadados é um recurso opcional para um cofre de extensões. O comando gerará um erro se um cofre não oferecer suporte a metadados secretos. Metadata é um objeto Hashtable que contém pares Nome/Valor. Os metadados são armazenados sem criptografia. Você não deve armazenar informações confidenciais nos metadados.
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 segredo Secret1 armazenado no cofre Vault1.
Get-SecretInfo recupera os metadados de Secret1 para mostrar os metadados adicionados.
Exemplo 2
Set-SecretInfo -Name Secret2 -Vault Vault2 -Metadata @{
Expiration = ([datetime]::new(2022, 5, 1))
}
Set-SecretInfo: Can't set secret metadata Secret2. Vault Vault2 doesn't support secret metadata.
Este exemplo adiciona metadados ao segredo Secret2 armazenado no cofre Vault2. No entanto, Vault2 não dá suporte a metadados. O comando falha e retorna um erro.
Exemplo 3
Get-SecretInfo -Name Secret3 |
Set-SecretInfo -Metadata @{ Created = (Get-Date) }
Este exemplo canaliza um objeto SecretInformation para o Set-SecretInfo comando e adiciona metadados ao segredo associado.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-InputObject
Esse parâmetro usa um objeto SecretInformation que define o segredo a ser atualizado.
Propriedades do parâmetro
| Tipo: | Microsoft.PowerShell.SecretManagement.SecretInformation |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
InfoParameterSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Metadata
Especifica um hashable 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 todos os metadados no hashtable devem ser um dos seguintes tipos:
- string
- int
- Data e hora
Os metadados não são armazenados com segurança em um cofre. Os metadados não devem conter informações confidenciais.
Propriedades do parâmetro
| Tipo: | Hashtable |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
NameParameterSet
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
System.Collections.Hashtable
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Especifica o nome do segredo ao qual adicionar metadados. Caracteres curinga (*) não são permitidos.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
NameParameterSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
NameParameterSet
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
