Set-SecretVaultDefault
將提供的保存庫名稱設定為目前用戶的預設保存庫。
語法
NameParameterSet (預設值)
Set-SecretVaultDefault
[-Name] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecretVaultParameterSet
Set-SecretVaultDefault
[-SecretVault] <SecretVaultInfo>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ClearParameterSet
Set-SecretVaultDefault
[-ClearDefault]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Important
PowerShell 團隊決定 Secret 模組功能已完整,將不再積極開發。 這些模組將持續提供安全及關鍵錯誤修正支援。 程式碼庫已被歸檔。
最新出版版本如下:
自從這個專案設計以來,祕密的本質已經徹底改變。 無密碼認證方法如通行金鑰、單一登入,以及聯邦憑證系統如 Microsoft Entra ID、生物辨識和硬體安全金鑰,是未來趨勢。
此 Cmdlet 會更新儲存庫登錄,將提供的保存庫名稱設定為預設保存庫。 只有一個已註冊的保存庫可以是預設保存庫。
範例
範例 1
PS C:\> Get-SecretVault
VaultName ModuleName IsDefaultVault
--------- ---------- --------------
CredMan Microsoft.PowerShell.CredManStore False
LocalStore Microsoft.PowerShell.SecretStore True
PS C:\> Set-SecretVaultDefault -Name CredMan
PS C:\> Get-SecretVault
VaultName ModuleName IsDefaultVault
--------- ---------- --------------
CredMan Microsoft.PowerShell.CredManStore True
LocalStore Microsoft.PowerShell.SecretStore False
PS C:\> Set-SecretVaultDefault -ClearDefault
PS C:\> Get-SecretVault
VaultName ModuleName IsDefaultVault
--------- ---------- --------------
CredMan Microsoft.PowerShell.CredManStore False
LocalStore Microsoft.PowerShell.SecretStore False
此範例示範如何設定和取消設定目前用戶的預設保存庫。 第一個命令會取得所有已註冊保存庫的相關信息,並顯示 LocalStore 是用戶的預設保存庫。 第二個命令會將 CredMan 保存庫設為預設保存庫。 第三個命令顯示 CredMan 保存庫現在是預設值,且 LocalStore 保存庫已不再預設。 第四個命令會使用 ClearDefault 參數,從任何已註冊的保存庫移除預設指定。 最後一個命令會顯示沒有預設保存庫。
參數
-ClearDefault
將isDefault 屬性 設定為所有已註冊保存庫的 $false。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ClearParameterSet
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
指定要設定為預設保存庫的已註冊保存庫名稱。 不允許通配符 (*)。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
NameParameterSet
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SecretVault
指定 SecretVaultInfo 物件,代表要設定為預設保存庫的已註冊保存庫。
參數屬性
| 類型: | Microsoft.PowerShell.SecretManagement.SecretVaultInfo |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
SecretVaultParameterSet
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 該 Cmdlet 未被執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。