Set-Tape

Set-Tape

Marks the specified tape as Archive, Cleaner, Free or Not Free.

Syntax

Set-Tape [-Tape] <Media> -NotFree [-PassThru <SwitchParameter>] [<CommonParameters>]


Set-Tape [-Tape] <Media> -Free [-PassThru <SwitchParameter>] [<CommonParameters>]


Set-Tape [-Tape] <Media> -Archive [-PassThru <SwitchParameter>] [<CommonParameters>]


Set-Tape [-Tape] <Media> -Cleaner [-PassThru <SwitchParameter>] [<CommonParameters>]

Detailed Description

The Set-Tape cmdlet marks the specified tape as Archive, Clearner, Free or Not Free.

Parameters

-Tape

Indicates a tape object.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

true (ByValue)

Position?

0

-Archive

Indicates that the media is no longer a cleaning tape and is now an archive tape.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-Cleaner

Indicates that the tape is a cleaning tape.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-Free

Indicates that the tape is free for use.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-NotFree

Indicates that the tape is not free for use.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-PassThru

The -PassThru parameter can be used with many commands in DPM to return a related object in cases where there is no default output. Using the PassThru parameter allows such cmdlets to be part of a pipeline.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-CommonParameter

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. For more information, see about_CommonParameters.

Input and Return Types

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.

Notes

  • For more information, type "Get-Help Set-Tape -detailed".
    For technical information, type "Get-Help Set-Tape -full".

    Additionally, any updated information about the cmdlet will be available at http://go.microsoft.com/fwlink/?LinkId=95130.

Examples

EXAMPLE 1

$DPMLib = Get-DPMLibrary -DPMServerName "TestingServer" 
$Tape = Get-Tape -DPMLibrary $DPMLib 
Set-Tape -Tape $Tape[1] -Free

This command marks the specified tape as Free.