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]

関連トピック

Add-DPMTape

Get-DPMLibrary

Get-DPMTape

Set-DPMTape