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>]
説明
Important
PowerShellチームは、Secretモジュールは機能が完結しており、今後積極的に開発されることはないと決定しました。 これらのモジュールは引き続きサポートされ、セキュリティや重大なバグ修正が行われます。 コードリポジトリはアーカイブされています。
最新に公開されたバージョンは以下の通りです:
このプロジェクトが設計されて以来、秘密の性質は根本的に変わりました。 パスキー、シングルサインオン、Microsoft Entra ID、生体認証、ハードウェアセキュリティキーなどのフェデレーテッド認証システムなどのパスワードレス認証方法が将来的に登場します。
このコマンドレットは、指定されたコンテナー名を既定のコンテナーとして設定するようにコンテナー レジストリを更新します。 既定のコンテナーにできるのは、登録済みのコンテナーが 1 つだけです。
例
例 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 がユーザーの既定のコンテナーであることを示します。 2 番目のコマンドは、CredMan コンテナーを既定のコンテナーにします。 3 番目のコマンドは、CredMan コンテナーが既定になり、LocalStore コンテナーが既定ではなくなったことを示しています。 4 番目のコマンドでは、ClearDefault パラメーターを使用して、登録済みコンテナーから既定の指定を削除します。 最後のコマンドは、既定のコンテナーがないことを示しています。
パラメーター
-ClearDefault
IsDefault プロパティを、登録されているすべてのコンテナーに対して $false に設定します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ClearParameterSet
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
既定のコンテナーとして設定する登録済みコンテナーの名前を指定します。 ワイルドカード文字 (*) は使用できません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameParameterSet
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SecretVault
既定のコンテナーとして設定する登録済みコンテナーを表す SecretVaultInfo オブジェクトを指定します。
パラメーターのプロパティ
| 型: | Microsoft.PowerShell.SecretManagement.SecretVaultInfo |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SecretVaultParameterSet
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。