SCVMM 2016 UR5 で利用可能なコマンドレット (Register-SCStorageFileShare) について

System Center 2016 – Virtual Machine Manager (SCVMM 2016) に触れる機会が多くなり、Virtual Machine Manager Command Shell を使った設定や、情報取得、および管理することが増えてきたので、備忘録として各コマンドレットの概要を日本語化 (意訳) しました。

ここでは Register-SCStorageFileShare コマンドレットのヘルプ情報について、SCVMM2016 UR5 の Virtual Machine Manager Command Shell 上で「Register-SCStorageFileShare」コマンドレットの -Full オプションを用いて実行した結果を元に記載しています。
※SCVMM 2016 UR5 で利用可能なコマンドレット一覧については、「System Center 2016 – Virtual Machine Manager で利用できるコマンドレットについて」を参照。

Register-SCStorageFileShare コマンドレット

名前

Register-SCStorageFileShare

概要

VM ホスト、クラスター、もしくはライブラリ サーバーに記憶域ファイル共有を登録します。

構文

Register-SCStorageFileShare  -FileSharePath <String>  [-JobGroup <Guid>]  [-JobVariable <String>]  [-PROTipID <Guid>]  [-RunAsynchronously]  -VMHost <Host>  [<CommonParameters>] Register-SCStorageFileShare  -FileSharePath <String>  [-JobGroup <Guid>]  [-JobVariable <String>]  [-PROTipID <Guid>]  [-RunAsynchronously]  -VMHostCluster <HostCluster>  [<CommonParameters>] Register-SCStorageFileShare  -FileSharePath <String>  [-JobGroup <Guid>]  [-JobVariable <String>]  -LibraryServer <LibraryServer>  [-PROTipID <Guid>]  [-RunAsynchronously]  [<CommonParameters>] Register-SCStorageFileShare  [-JobGroup <Guid>]  [-JobVariable <String>]  -LibraryServer <LibraryServer>  [-PROTipID <Guid>]  [-RunAsynchronously]  -StorageFileShare <StorageFileShare>  [<CommonParameters>] Register-SCStorageFileShare  [-JobGroup <Guid>]  [-JobVariable <String>]  [-PROTipID <Guid>]  [-RunAsynchronously]  -StorageFileShare <StorageFileShare>  -VMHost <Host>  [<CommonParameters>] Register-SCStorageFileShare  [-JobGroup <Guid>]  [-JobVariable <String>]  [-PROTipID <Guid>]  [-RunAsynchronously]  -StorageFileShare <StorageFileShare>  -VMHostCluster <HostCluster>  [<CommonParameters>]

説明

Register-SCStorageFileShare コマンドレットは、仮想マシン ホスト、クラスター、もしくはライブラリ サーバーに記憶域ファイル共有を登録します。

パラメーター

-FileSharePath <String>

ファイル共有へのパスを指定します。

必須	true
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-JobGroup <Guid>

同じジョブ グループ識別子を含む最後のコマンドが実行される直前に、一連のコマンドを実行する一連のコマンドの識別子を指定します。

必須	false
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-JobVariable <String>

ジョブの進行状況を追跡し、このパラメーターで指定された変数に格納する場合に指定します。

必須	false
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-LibraryServer <LibraryServer>

VMM ライブラリ サーバー オブジェクトを指定します。

必須	true
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-PROTipID <Guid>

このアクションにトリガーされるパフォーマンスとリソースの最適化のヒント (PRO ヒント) を指定します。このパラメーターは、PRO ヒントを監査することができます。

必須	false
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-RunAsynchronously [<SwitchParameter>]

ジョブが非同期で実行、制御がすぐにコマンド シェルに戻されるかどうかを指定します。

必須	false
位置	named
既定値	False
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-StorageFileShare <StorageFileShare>

記憶域ファイル共有を指定します。

必須	true
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-VMHost <Host>

仮想マシン ホスト オブジェクトを指定します。VMM は、Hyper-V ホスト、VMware ESX ホスト、および Citrix XenServer ホストをサポートします。

各ホストの種類に関する情報について、Add-SCVMHost コマンドレットを参照してください。

必須	true
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-VMHostCluster <HostCluster>

VMM ホスト クラスター オブジェクトを指定します。

必須	true
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer, PipelineVariable、および OutVariable。詳細については、about_CommonParameters を参照してください。

入力

出力

• StorageFileShare
  • このコマンドレットは、StorageFileShare オブジェクトを返します。

メモ

例

例 1 : ライブラリ サーバーを持つ記憶域ファイル共有を登録する

コマンド

$FileShare = Get-SCStorageFileShare -Name "FileShare01" 
$LibServer = Get-SCLibraryServer -ComputerName "LibraryServer01.Contoso.com"
Register-SCStorageFileShare -StorageFileShare $FileShare -LibraryServer $LibServer

コマンドの説明

最初のコマンドは、記憶域ファイル共有 オブジェクト “FileShare01” を取得し、そのオブジェクトを $FileShare 変数に格納します。

2 番目のコマンドは、VMM ライブラリ サーバー オブジェクト “LibraryServer01.Contoso.com” を取得し、そのオブジェクトを $LibServer 変数に格納します。

最後のコマンドは、LibraryServer01 に FileShare01 を登録します。

関連するリンク

• Get-SCLibraryServer
• Get-SCStorageFileShare
• New-SCStorageFileShare
• Remove-SCStorageFileShare
• Repair-SCStorageFileShare
• Set-SCStorageFileShare
• Unregister-SCStorageFileShare

参考

• System Center 2016 – データセンターの管理 | Microsoft
  https://www.microsoft.com/ja-jp/cloud-platform/system-center
• VirtualMachineManager | Microsoft Docs
  https://docs.microsoft.com/en-us/powershell/module/virtualmachinemanager/?view=systemcenter-ps-2016
• Register-SCStorageFileShare (VirtualMachineManager) | Microsoft Docs
  https://docs.microsoft.com/en-us/powershell/module/virtualmachinemanager/register-scstoragefileshare?view=systemcenter-ps-2016