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

ブログ エントリ内にアフィリエイト広告が含まれています
スポンサーリンク

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

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

Unregister-SCStorageFileShare コマンドレット

名前

Unregister-SCStorageFileShare

概要

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

構文

Unregister-SCStorageFileShare
 [-StorageFileShare] <StorageFileShare>
 [-JobGroup <Guid>]
 [-JobVariable <String>]
 -LibraryServer <LibraryServer>
 [-PROTipID <Guid>]
 [-RemovePermissionsFromShare]
 [-RunAsynchronously]
 [<CommonParameters>]

Unregister-SCStorageFileShare
 [-StorageFileShare] <StorageFileShare>
 [-JobGroup <Guid>]
 [-JobVariable <String>]
 [-PROTipID <Guid>]
 [-RemovePermissionsFromShare]
 [-RunAsynchronously]
 -VMHost <Host>
 [<CommonParameters>]

Unregister-SCStorageFileShare
 [-StorageFileShare] <StorageFileShare>
 [-JobGroup <Guid>]
 [-JobVariable <String>]
 [-PROTipID <Guid>]
 [-RemovePermissionsFromShare]
 [-RunAsynchronously]
 -VMHostCluster <HostCluster>
 [<CommonParameters>]

説明

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

パラメーター

-JobGroup <Guid>

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

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

-JobVariable <String>

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

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

-LibraryServer <LibraryServer>

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

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

-PROTipID <Guid>

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

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

-RemovePermissionsFromShare [<SwitchParameter>]

ファイル共有からアクセス許可を削除する場合に指定します。

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

-RunAsynchronously [<SwitchParameter>]

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

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

-StorageFileShare <StorageFileShare>

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

必須 true
位置 0
既定値 None
パイプライン入力を許可する True (ByValue)
ワイルドカード文字を許可する 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 を参照してください。

入力

出力

メモ

例 1 : ライブラリ サーバーから記憶域ファイル共有を登録解除する

コマンド
$FileShare = Get-SCStorageFileShare -Name "FileShare01" 
$LibServer = Get-SCLibraryServer -ComputerName "LibraryServer01.Contoso.com"
Unregister-SCStorageFileShare -StorageFileShare $FileShare -LibraryServer $LibServer
コマンドの説明

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

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

最後のコマンドは、LibraryServer01 から FileShare01 を登録解除します。

関連するリンク

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

参考

タイトルとURLをコピーしました