Add-SCLibraryShare

ライブラリ サーバーのファイル システム上の Windows 共有をライブラリ共有として VMM ライブラリに追加します。

構文

Add-SCLibraryShare
   [-VMMServer <ServerConnection>]
   [-SharePath] <String>
   [-Credential <PSCredential>]
   [-Description <String>]
   [-AddDefaultResources]
   [-JobGroup <Guid>]
   [-UseAlternateDataStream <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

Add-SCLibraryShare コマンドレットは、ライブラリ サーバーのファイル システム上の Windows 共有をライブラリ共有として Virtual Machine Manager (VMM) ライブラリに追加します。

ライブラリ共有を VMM ライブラリに追加するには、まず Windows ファイル システムで共有を作成する必要があります。 たとえば、エクスプローラーを使用して、ライブラリに追加するフォルダーを作成して共有できます。

VMM セットアップまたは別のライブラリ サーバーで作成された既定のライブラリ共有 (MSSCVMMLibrary) と同じレベルで Windows 共有を作成する場合は、Add-SCLibraryShare コマンドレットを使用して、その共有を VMM ライブラリに追加します。

既定の VMM ライブラリ共有 (MSSCVMMLibrary) の下に Windows フォルダーを作成すると、VMM は自動的に共有をスキャンし、その共有に格納されているすべての既存のオブジェクトを検出して、ライブラリ オブジェクトとして修飾し、ライブラリ オブジェクトをライブラリに追加します。 ただし、Read-SCLibraryShare コマンドレットを使用して、その共有を手動で更新し、その内容を VMM ライブラリにインポートできます。

注: ライブラリ リフレッシャーによってのみ検出できるが、管理者が作成できないライブラリ リソースには、仮想ハード ディスク (Windows ベースの .vhd ファイル、Citrix XenServer ベースの .vhd ファイルまたは VMware ベースの .vmdk ファイル)、仮想フロッピー ディスク (Windows ベースの .vfd ファイルまたは VMware ベースの .flp ファイル)、ISO イメージ (.iso ファイル)、スクリプトが含まれます。

例 1: ライブラリ共有オブジェクトとして VMM ライブラリに Windows 共有を追加する

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Add-SCLibraryShare -SharePath "\\LibraryServer01\AllVHDs"

最初のコマンドは VMMServer01 に接続します。

2 番目のコマンドは、AllVHDs という名前のライブラリ (LibraryServer01 にある Windows 共有) にライブラリ共有オブジェクトを追加します。 この例では、LibraryServer01 が既に VMM ライブラリ サーバーであることを前提としています。

例 2: ライブラリ共有オブジェクトとして 2 つの Windows 共有を VMM ライブラリに追加する

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $SharePaths = "\\LibraryServer01\AllVHDs", "\\LibraryServer01\AllISOs"
PS C:\> ForEach($SharePath in $SharePaths) { Add-SCLibraryShare -SharePath $SharePath }

最初のコマンドは VMMServer1 に接続します。

2 番目のコマンドは、文字列 "\LibraryServer01\AllVHDs" と "\LibraryServer01\AllSOs" を$SharePaths変数に格納します。 この例では、LibraryServer01 が既に VMM ライブラリ サーバーであることを前提としています。

最後のコマンドでは、ForEach ループを使用して、$SharePathsに格納されている 2 つの共有名を Add-SCLibraryShare コマンドレットに渡し、各 Windows 共有をライブラリ共有として VMM に追加します。

注: 標準の Windows PowerShell ForEach ループ ステートメントの詳細については、「Get-Help about_ForEach」と入力します。 ForEach ループ ステートメントは、ForEach をエイリアスとして使用する ForEach-Object コマンドレットと同じではありません。

パラメーター

-AddDefaultResources

ライブラリ共有の既定のリソースが追加されることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

資格情報オブジェクトを指定するか、一部のコマンドレットに対して、このアクションを実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む実行アカウント オブジェクトを指定します。 または、Restart-SCJobの場合は、再起動されたタスクを完了するアクセス許可を持ちます。

PSCredential オブジェクトの詳細については、「Get-Help Get-Credential」と入力します。

実行アカウントの詳細については、「Get-Help New-SCRunAsAccount」と入力します。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

ライブラリ共有の説明を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-JobGroup

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

型:Guid
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-JobVariable

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PROTipID

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

型:Guid
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SharePath

汎用名前付け規則 (UNC) パスを使用する既存のライブラリ サーバー上の有効なライブラリ共有へのパスを指定します。

形式の例: -SharePath "\\LibServer01\LibShare"

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UseAlternateDataStream

AlternateDataStream を使用するかどうかを指定します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VMMServer

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

型:ServerConnection
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

出力

LibraryShare

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