Set-DPMTape

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

Syntax

Set-DPMTape [-Tape] <Media[]> [-Archive] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-DPMTape [-Tape] <Media[]> [-Cleaner] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-DPMTape [-Tape] <Media[]> [-Free] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-DPMTape [-Tape] <Media[]> [-NotFree] [-PassThru] [-Confirm] [-WhatIf] [<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
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Cleaner

Indicates that the media is a cleaning tape.

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

Indicates that the media is free for use.

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

Indicates that the media is not free for use.

Type:SwitchParameter
Required:True
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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[]
Required:True
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

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

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

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

Outputs

Tape