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 オブジェクトを返します。