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
此 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。
參數屬性
參數集
ClearParameterSet
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
參數集
(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 未被執行。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
None
輸出
None