This topic has not yet been rated - Rate this topic

Set-DPMTape

Updated: January 14, 2013

Applies To: System Center 2012 - Data Protection Manager

Set-DPMTape

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

Syntax

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>]

Detailed Description

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

Parameters

-Archive

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

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Cleaner

Indicates that the tape is a cleaning tape.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Free

Indicates that the tape is free for use.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-NotFree

Indicates that the tape is not free for use.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-PassThru

Use the PassThru parameter to allow cmdlets to be part of a pipeline. 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.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Tape<Media[]>

Indicates a tape object.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-Confirm

Prompts you for confirmation before executing the command.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

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

Inputs

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

Outputs

The output type is the type of the objects that the cmdlet emits.

Tape

Notes

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

For technical information, type "Get-Help Set-DPMTape -full".

Examples

EXAMPLE 1

This command marks the specified tape as Free.

PowerShell

PS C:\>$DPMLib = Get-DPMLibrary -DPMServerName "TestingServer"$Tape = Get-Tape -DPMLibrary $DPMLibSet-DPMTape -Tape $Tape[1] -Free

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)