Unregister-SecretVault
現在のユーザーの SecretManagement から拡張機能コンテナーの登録を解除します。
構文
Unregister-SecretVault
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Unregister-SecretVault
[-SecretVault] <SecretVaultInfo>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットは、指定された拡張コンテナーの登録を解除します。 登録が解除されると、現在のユーザーの SecretManagement でコンテナーを使用できなくなります。
例
例 1
PS C:\> Get-SecretVault
VaultName ModuleName IsDefaultVault
--------- ---------- --------------
CredMan Microsoft.PowerShell.CredManStore False
LocalStore Microsoft.PowerShell.SecretStore True
PS C:\> Unregister-SecretVault LocalStore
PS C:\> Get-SecretVault
VaultName ModuleName IsDefaultVault
--------- ---------- --------------
CredMan Microsoft.PowerShell.CredManStore False
PS C:\> Get-Secret -Name Secret5
Get-Secret: The secret Secret5 was not found.
PS C:\> Register-SecretVault -Name SecretStore -ModuleName Microsoft.PowerShell.SecretStore -DefaultVault
PS C:\> Get-SecretVault
VaultName ModuleName IsDefaultVault
--------- ---------- --------------
CredMan Microsoft.PowerShell.CredManStore False
SecretStore Microsoft.PowerShell.SecretStore True
PS C:\> Get-Secret -Name Secret5
System.Security.SecureString
最初のコマンドは、現在のユーザーの登録済みコンテナーを一覧表示します。 2 番目のコマンドは、コンテナーの登録を LocalStore
解除します。 3 番目のコマンドは、コンテナーがレジストリに表示されなくなったことを確認します。
4 番目のコマンドは を取得 Secret5
しようとしますが、コンテナーが登録されていないため見つかりません。 5 番目のコマンドは、別の名前でコンテナーを再登録し、ユーザーの既定のコンテナーとして設定します。 6 番目のコマンドは、コンテナーが として再登録され SecretStore
、既定のコンテナーであることを確認します。 最後に、最後のコマンドは Secret5
、再登録されたコンテナーからを取得します。
例 2
PS C:\> Get-SecretVault | Unregister-SecretVault
PS C:\> Get-SecretVault
次の使用例は、現在のユーザーのすべての拡張コンテナーの登録を解除します。 2 番目のコマンドは、コンテナーが登録されていないことを示しています。
次の使用例は、現在のユーザーのすべての拡張コンテナーの登録を解除します。 Get-SecretVault
は、現在のユーザーのすべての登録済みコンテナーを取得し、パイプラインを介して 結果を に Unregister-SecretVault
送信します。 Get-SecretVault
は、シークレットがコンテナーに存在しなくなったことを示しています。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
登録解除するコンテナーの名前を指定します。 名前または名前パターンを入力します。 ワイルドカード文字 (*
) を使用できます。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-SecretVault
登録解除するコンテナーを表す SecretVaultInfo オブジェクトを指定します。
Type: | SecretVaultInfo |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.PowerShell.SecretManagement.SecretVaultInfo
出力
None
PowerShell