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 https://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.