System Center 2016 – Data Protection Manager (DPM 2016) の DPM 管理シェルは、PowerShell を用いたコマンドライン インタフェースです。
DPM 管理シェルは、デスクトップ上のアイコン、もしくは [スタート メニュー] – [Microsoft System Center 2016] – [DPM 管理シェル] を選択、クリックすることで起動することが可能です。
DPM 2016 の管理を目的として様々なコマンドレットが DPM 管理シェルに用意されていますが、 コマンドレットのヘルプについては、日本語の情報は公開されていません。
このヘルプ情報について、「Get-Help」コマンドレットの -Full オプションを用いて実行した結果を編集、意訳しました。
この記事では、「Set-DPMTape」コマンドレットについて記載します (他のコマンドレットについては、「System Center 2016 – Data Protection Manager の DPM 管理シェルで使用できるコマンドレットについて」を参照)。
Set-DPMTape コマンドレット
名前
Set-DPMTape
エイリアス
Set-Tape
概要
“Archive”、”Cleaner”、”Free”、もしくは “Not Free” としてテープをマークします。
構文
Set-DPMTape [-Tape] <Media[]> [-PassThru] -Archive [-Confirm] [-WhatIf] [<CommonParameters>]
Set-DPMTape [-Tape] <Media[]> [-PassThru] -Cleaner [-Confirm] [-WhatIf] [<CommonParameters>] Set-DPMTape [-Tape] <Media[]> [-PassThru] -Free [-Confirm] [-WhatIf] [<CommonParameters>] Set-DPMTape [-Tape] <Media[]> [-PassThru] -NotFree [-Confirm] [-WhatIf] [<CommonParameters>] |
説明
Set-DPMTape コマンドレットは、”Archive”、”Cleaner”、”Free”、もしくは “Not Free” としてテープをマークします。
パラメーター
-Archive <SwitchParameter>
メディアがアーカイブ テープの場合に指定します。
必須 | true |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-Cleaner <SwitchParameter>
メディアがクリーニング テープの場合に指定します。
必須 | true |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-Free <SwitchParameter>
メディアが使用可能である場合に指定します。
必須 | true |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-NotFree <SwitchParameter>
メディアが使用可能でない場合に指定します。
必須 | true |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-PassThru [<SwitchParameter>]
作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットは、出力を生成しません。
必須 | false |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-Tape <Media[]>
このコマンドレットが、操作するテープの配列を指定します。Tape オブジェクトを取得するには、Get-DPMTape コマンドレットを用います。
必須 | true |
位置 | 1 |
既定値 | なし |
パイプライン入力を許可する | true (ByValue) |
ワイルドカード文字を許可する | false |
-Confirm [<SwitchParameter>]
コマンドレットを実行する前に確認のプロンプトを表示します。
必須 | false |
位置 | named |
既定値 | false |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-WhatIf [<SwitchParameter>]
コマンドレットを実行する場合、何が起きるかを表示します。コマンドレットは実行されません。
必須 | false |
位置 | named |
既定値 | false |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-WarningAction、-WarningVariable、-OutBuffer、-PipelineVariable、および -OutVariable。詳細については、about_CommonParameters を参照してください。
入力
入力の種類は、コマンドレットにパイプ可能なオブジェクトの種類です。
出力
出力の種類は、コマンドレットが発行するオブジェクトの種類です。
- Tape
例
例 1 : 空きテープとしてマークする
$DpmLibrary = Get-DPMLibrary -DPMServerName "Contoso-DPMServer" $DpmTape = Get-Tape -DPMLibrary $DpmLibrary Set-DPMTape -Tape $DpmTape[1] -Free
最初のコマンドは、Get-DPMLibrary コマンドレットを用いて DPM サーバー「Contoso-DPMServer」のライブラリを取得し、変数 $DpmLibrary に格納します。
2 番目のコマンドは、Get-DPMTape コマンドレットを用いてテープ オブジェクトを取得、変数 $DpmTape に格納します。
3 番目のコマンドは、”Free” として 2 番目のテープを設定します。
関連するリンク
- Add-DPMTape
- Get-DPMLibrary
- Get-DPMTape
- Remove-DPMTape
参考
- Data Protection Manager Cmdlets
https://technet.microsoft.com/en-us/library/hh881730(v=sc.30).aspx - Set-DPMTape
https://technet.microsoft.com/en-us/library/hh881604(v=sc.30).aspx