Register-SecretVault
Registra un modulo dell'insieme di credenziali dell'estensione SecretManagement per l'utente corrente.
Sintassi
Default (Impostazione predefinita)
Register-SecretVault
[-ModuleName] <String>
[[-Name] <String>]
[-VaultParameters <Hashtable>]
[-DefaultVault]
[-AllowClobber]
[-PassThru]
[-Description <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Important
Il team PowerShell ha deciso che i moduli Secret sono completi in funzionalità e non saranno più sviluppati attivamente. I moduli continueranno a essere supportati per la sicurezza e la correzione di bug critici. Il repository di codice verrà archiviato.
Le ultime versioni pubblicate sono:
La natura dei segreti è cambiata radicalmente da quando è stato progettato questo progetto. Metodi di autenticazione senza password come passkey, single sign-on e sistemi di credenziali federati come Microsoft Entra ID, biometria e chiavi di sicurezza hardware sono il futuro.
Questo cmdlet aggiunge un insieme di credenziali dell'estensione SecretManagement al Registro di sistema dell'insieme di credenziali dell'utente corrente. Un insieme di credenziali di estensione è un modulo di PowerShell conforme al formato di insieme di credenziali di estensione richiesto. Questo cmdlet verifica che il modulo specificato soddisfi i requisiti di conformità prima di aggiungerlo al Registro di sistema dell'insieme di credenziali dell'estensione. Gli insiemi di credenziali delle estensioni vengono registrati per l'utente corrente e non influiscono sulle registrazioni di altri insiemi di credenziali degli utenti.
Il primo insieme di credenziali registrato con questo cmdlet viene definito automaticamente come insieme di credenziali predefinito anche se il parametro DefaultVault non è specificato.
Esempio
Esempio 1
Register-SecretVault -Name LocalStore -ModuleName Microsoft.PowerShell.SecretStore -DefaultVault
Get-SecretVault
VaultName ModuleName IsDefaultVault
--------- ---------- --------------
CredMan Microsoft.PowerShell.CredManStore False
LocalStore Microsoft.PowerShell.SecretStore True
In questo esempio viene registrato un insieme di credenziali dell'estensione Microsoft.PowerShell.SecretStore per l'utente corrente.
Utilizza il parametro DefaultVault per impostare l'insieme di credenziali registrato come insieme di credenziali predefinito per l'utente.
Get-SecretVault Elenca tutti gli archivi di credenziali registrati per l'utente, verificando che l'insieme di credenziali sia stato registrato e impostato come archivio di default.
Esempio 2
$parameters = @{
Name = 'Azure'
ModuleName = 'Az.KeyVault'
VaultParameters = @{
AZKVaultName = 'AzureKeyVault'
SubscriptionId = (Get-AzContext).Subscription.Id
}
DefaultVault = $true
}
Register-SecretVault @parameters
Get-SecretVault
Name ModuleName IsDefaultVault
---- ---------- --------------
Azure Az.KeyVault True
In questo esempio viene registrato un insieme di credenziali dell'estensione Az.KeyVault per l'utente corrente. Il modulo Az.KeyVault deve essere installato in precedenza. Per i parametri del vault:
-
AZKVaultNamespecifica il nome dell'insieme di credenziali delle chiavi in Azure -
SubscriptionIdspecifica l'ID della sottoscrizione in cui viene creato l'insieme di credenziali delle chiavi
Parametri
-AllowClobber
Se specificato, consente al cmdlet di sovrascrivere un insieme di credenziali di estensione registrato esistente con lo stesso nome.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DefaultVault
Se specificato, imposta il nuovo insieme di credenziali dell'estensione come insieme di credenziali predefinito per l'utente corrente.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Description
Viene descritto l'insieme di credenziali. Questo valore è incluso nelle informazioni del Registro di sistema dell'insieme di credenziali.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ModuleName
Specifica il nome del modulo di PowerShell che implementa l'insieme di credenziali delle estensioni. Immettere il nome di un modulo o il percorso del modulo. Se si specifica un nome, PowerShell lo cerca nei percorsi noti dei moduli. Se si specifica un percorso, PowerShell cerca il modulo in tale percorso.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Specifica il nome dell'insieme di credenziali delle estensioni. Se non viene specificato alcun nome, il nome del modulo viene utilizzato come nome dell'insieme di credenziali.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PassThru
Indica che il cmdlet deve restituire l'oggetto SecretVaultInfo per l'insieme di credenziali dell'estensione registrato correttamente. Per impostazione predefinita, questo cmdlet non restituisce alcun output.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-VaultParameters
Specifica un oggetto Hashtable contenente coppie chiave-valore facoltative utilizzate come parametri dall'insieme di credenziali dell'estensione. Questi parametri sono facoltativi. Consultare la documentazione del modulo di estensione del vault per vedere quali valori sono richiesti.
Proprietà dei parametri
| Tipo: | Hashtable |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.