Freigeben über


Remove-DPMTape

Entfernt ein Band aus einer DPM-Bibliothek.

Syntax

Remove-DPMTape
      [-DPMLibrary] <Library>
      [-Tape] <Media[]>
      [-Async]
      [-JobStateChangedEventHandler <JobStateChangedEventHandler>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das cmdlet Remove-DPMTape entfernt ein Band aus einer System Center - Data Protection Manager (DPM)-Bibliothek.

Beispiele

Beispiel 1: Entfernen eines Bandes aus einer Bibliothek

PS C:\>$DpmLibrary = Get-DPMLibrary -DPMServerName "Contoso-DPMServer"
PS C:\> $DpmTape = Get-DPMTape -DPMLibrary $DpmLibrary
PS C:\> Unlock-DPMLibraryDoor -DPMLibrary $DpmLibrary
PS C:\> Remove-DPMTape -DPMLibrary $DpmLibrary -Tape $DpmTape[2]

Der erste Befehl verwendet die Get-DPMLibrary Cmdlet, um die Bibliothek für den Server abzurufen. Der Befehl speichert das Ergebnis in der $DpmLibrary Variablen.

Der zweite Befehl verwendet das cmdlet Get-DPMTape zum Abrufen des Bandobjekts. Der Befehl speichert das Ergebnis in der variablen $DpmTape.

Der dritte Befehl verwendet die Unlock-DPMLibraryDoor Cmdlet, um die Bandtür zu entsperren.

Der letzte Befehl entfernt das dritte Band aus der Bibliothek.

Parameter

-Async

Gibt an, dass der Befehl asynchron ausgeführt wird. Wenn Sie einen Befehl asynchron ausführen, wird die Eingabeaufforderung sofort zurückgegeben, auch wenn der Auftrag eine längere Zeit benötigt, um den Vorgang abzuschließen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DPMLibrary

Gibt eine DPM-Bibliothek an, aus der dieses Cmdlet ein Band entfernt. Verwenden Sie das Cmdlet Get-DPMLibrary, um ein DPM-Bibliotheksobjekt abzurufen.

Typ:Library
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-JobStateChangedEventHandler

Gibt einen Ereignishandler für Job.StateChanged-Ereignisse an. Verwenden Sie diesen Parameter, um eine grafische Benutzeroberfläche basierend auf Cmdlets zu erstellen. Verwenden Sie diesen Parameter nicht in der DPM-Verwaltungsshell.

Typ:JobStateChangedEventHandler
Aliase:Handler
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Tape

Gibt ein Array von Bandobjekten an, die dieses Cmdlet entfernt. Um ein Tape-Objekt abzurufen, verwenden Sie das cmdlet Get-DPMTape.

Typ:Media[]
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False