Set-SecretInfo
Voegt extra geheime metagegevens toe of vervangt deze aan een geheim dat momenteel is opgeslagen in een kluis.
Syntaxis
NameParameterSet (Standaard)
Set-SecretInfo
[-Name] <String>
[-Metadata] <Hashtable>
[[-Vault] <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InfoParameterSet
Set-SecretInfo
[-Metadata] <Hashtable>
-InputObject <SecretInformation>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Deze cmdlet voegt extra geheime metagegevens toe aan een bestaand geheim. Ondersteuning voor metagegevens is een optionele functie voor een extensiekluis. De opdracht genereert een foutmelding als een kluis geen geheime metadata ondersteunt. Metagegevens zijn een hashtabelobject dat naam/waarde-paren bevat. De metadata worden onversleuteld opgeslagen. U moet geen gevoelige informatie opslaan in de metagegevens.
Voorbeelden
Voorbeeld 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]}
In dit voorbeeld worden metagegevens toegevoegd aan het Secret1 geheim dat is opgeslagen in Vault1 kluis.
Get-SecretInfo haalt de metagegevens voor Secret1 op om de toegevoegde metagegevens weer te geven.
Voorbeeld 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.
In dit voorbeeld worden metagegevens toegevoegd aan het Secret2 geheim dat is opgeslagen in Vault2 kluis.
Vault2 biedt echter geen ondersteuning voor metagegevens. De opdracht mislukt en retourneert een fout.
Voorbeeld 3
Get-SecretInfo -Name Secret3 |
Set-SecretInfo -Metadata @{ Created = (Get-Date) }
In dit voorbeeld wordt een SecretInformation-object naar de Set-SecretInfo opdracht geleid en worden metagegevens toegevoegd aan het bijbehorende geheim.
Parameters
-Confirm
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-InputObject
Met deze parameter wordt een SecretInformation-object gebruikt dat het geheim definieert dat moet worden bijgewerkt.
Parametereigenschappen
| Type: | Microsoft.PowerShell.SecretManagement.SecretInformation |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
InfoParameterSet
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Metadata
Hiermee geeft u een Hashtable met sleutel-waardeparen te koppelen aan het geheim in de kluis. De opgegeven extensiekluis biedt mogelijk geen ondersteuning voor geheime metagegevens. Als de kluis geen ondersteuning biedt voor metagegevens, mislukt de bewerking en wordt er een fout geretourneerd. De waarden van metagegevens in de hashtabel moeten een van de volgende typen zijn:
- string
- int
- Datum/tijd
Metagegevens worden niet veilig opgeslagen in een kluis. Metagegevens mogen geen gevoelige informatie bevatten.
Parametereigenschappen
| Type: | Hashtable |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
NameParameterSet
| Position: | 1 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
System.Collections.Hashtable
| Position: | 1 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Name
Hiermee geeft u de naam van het geheim waaraan metagegevens moeten worden toegevoegd. Jokertekens (*) zijn niet toegestaan.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
NameParameterSet
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Vault
Hiermee geeft u de naam op van de kluis die het geheim bevat om de metagegevens voor toe te voegen of bij te werken. Jokertekens (*) zijn niet toegestaan. Deze cmdlet zoekt standaard naar het geheim in de standaardkluis van de huidige gebruiker.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
NameParameterSet
| Position: | 2 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
