Remove-DPMTape
Remove-DPMTape
Removes a tape from a DPM library.
構文
Parameter Set: Default
Remove-DPMTape [-DPMLibrary] <Library> [-Tape] <Media[]> [-Async] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The Remove-DPMTape cmdlet removes a tape from a System Center 2012 – Data Protection Manager (DPM) library.
パラメーター
-Async
Indicates that the command runs asynchronously. When you run a command asynchronously, the command prompt returns immediately even if the job takes an extended time to finish.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-DPMLibrary<Library>
Specifies a DPM library object.
エイリアス |
none |
必須? |
true |
位置は? |
1 |
既定値 |
none |
パイプライン入力を許可する |
true (ByValue) |
ワイルドカード文字を許可する |
false |
-JobStateChangedEventHandler<JobStateChangedEventHandler>
Indicates that the cmdlet displays the status of the operation to the user. Use this parameter in conjunction with the Async parameter.
エイリアス |
Handler |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Tape<Media[]>
Specifies an array of tape objects.
エイリアス |
none |
必須? |
true |
位置は? |
2 |
既定値 |
none |
パイプライン入力を許可する |
true (ByValue) |
ワイルドカード文字を許可する |
false |
-Confirm
コマンドレットを実行する前に、ユーザーに確認を求めます。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WhatIf
コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
注
- For more information, type "
Get-Help Remove-DPMTape -detailed
".
例
Example 1: Remove a tape from a library
This example removes a tape from the library.
The first command uses the Get-DPMLibrary cmdlet to retrieve the library for the server, and stores the result in the $DPMLib variable.
The second command uses the Get-Tape cmdlet to retrieve the tape object, and stores the result in the $Tape variable.
The third command uses the Unlock-DPMLibraryDoor cmdlet to unlock the tape door.
The fourth command uses the Remove-DPMTape cmdlet to remove the third tape from the library.
PS C:\> $DPMLib = Get-DPMLibrary -DPMServerName "Contoso-DPMServer"
PS C:\> $Tape = Get-Tape -DPMLibrary $DPMLib
PS C:\> Unlock-DPMLibraryDoor -DPMLibrary $DPMLib
PS C:\> Remove-DPMTape -DPMLibrary $DPMLib -Tape $Tape[2]