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 ファイル システムに共有を作成しておく必要があります。 たとえば、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: ライブラリ共有オブジェクトとしての Windows 共有を VMM ライブラリに追加する
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 に追加します。
注: ForEach ループステートメントの標準Windows PowerShellの詳細については、「.」と入力しますGet-Help about_ForEach。
ForEach ループ ステートメントは、エイリアスとして ForEach を使用する ForEach-Object コマンドレットと同じではありません。
パラメーター
-AddDefaultResources
ライブラリ共有の既定のリソースが追加されることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
資格情報オブジェクトを指定するか、一部のコマンドレットに対して、このアクションを実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む実行アカウント オブジェクトを指定します。 または、 Restart-SCJob の場合は、再起動されたタスクを完了するためのアクセス許可を持ちます。
PSCredential オブジェクトの詳細については、「Get-Help Get-Credential.
実行アカウントの詳細については、「.」と入力します Get-Help New-SCRunAsAccount。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
ライブラリ共有の説明を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
同じジョブ グループ識別子を含む最後のコマンドが実行される直前に一括して実行される、一連のコマンドの識別子を指定します。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SharePath
汎用名前付け規則 (UNC) パスを使用する既存のライブラリ サーバー上にある有効なライブラリ共有へのパスを指定します。
形式の例: -SharePath "\\LibServer01\LibShare"
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseAlternateDataStream
AlternateDataStream を使用するかどうかを指定します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
出力
LibraryShare
このコマンドレットは LibraryShare オブジェクトを返します。