Set-DPMTape

Set-DPMTape

Marks a tape as Archive, Cleaner, Free or Not Free.

構文

Parameter Set: Archive
Set-DPMTape [-Tape] <Media[]> -Archive [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Cleaner
Set-DPMTape [-Tape] <Media[]> -Cleaner [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Free
Set-DPMTape [-Tape] <Media[]> -Free [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Unfree
Set-DPMTape [-Tape] <Media[]> -NotFree [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Set-DPMTape cmdlet marks a tape as Archive, Cleaner, Free or Not Free.

パラメーター

-Archive

Indicates that the media is an archive tape.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Cleaner

Indicates that the media is a cleaning tape.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Free

Indicates that the media is free for use.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-NotFree

Indicates that the media is not free for use.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-PassThru

Indicates that the cmdlet is part of a pipeline. Use this parameter with System Center 2012 – Data Protection Manager (DPM) commands to return a related object in cases where there is no default output.

エイリアス

none

必須?

false

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Tape<Media[]>

Specifies an array of tape objects.

エイリアス

none

必須?

true

位置は?

1

既定値

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)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

  • Tape

  • For more information, type "Get-Help Set-DPMTape -detailed".

Example 1: Mark a tape as free

This example marks a tape as Free.

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 Set-DPMTape cmdlet to set the second tape as Free.

PS C:\> $DPMLib = Get-DPMLibrary -DPMServerName "Contoso-DPMServer"
PS C:\> $Tape = Get-Tape -DPMLibrary $DPMLib
PS C:\> Set-DPMTape -Tape $Tape[1] -Free

関連トピック

Add-DPMTape

Get-DPMLibrary

Get-DPMTape

Remove-DPMTape