Set-DPMTape

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

Syntax

Set-DPMTape
   [-Tape] <Media[]>
   [-Archive]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMTape
   [-Tape] <Media[]>
   [-Cleaner]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMTape
   [-Tape] <Media[]>
   [-Free]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMTape
   [-Tape] <Media[]>
   [-NotFree]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

Examples

Example 1: Mark a tape as free

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

The first command uses the Get-DPMLibrary cmdlet to retrieve the library for the server, and then stores it in the $DpmLibrary variable.

The second command uses the Get-DPMTape cmdlet to retrieve the tape object, and then stores it in the $DpmTape variable.

The third command sets the second tape as Free.

Parameters

-Archive

Indicates that the media is an archive tape.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Cleaner

Indicates that the media is a cleaning tape.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Free

Indicates that the media is free for use.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NotFree

Indicates that the media is not free for use.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tape

Specifies an array of tapes on which this cmdlet operates. To obtain a Tape object, use the Get-DPMTape cmdlet.

Type:Media[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Tape