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