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 cmdlet 将库服务器的文件系统上的 Windows 共享作为库共享添加到 Virtual Machine Manager (VMM) 库。
必须先在 Windows 文件系统中创建共享,然后才能将库共享添加到 VMM 库。 例如,可以使用 Windows 资源管理器创建和共享要添加到库的文件夹。
如果在 VMM 安装程序创建的默认库共享(MSSCVMMLibrary)或单独库服务器上创建 Windows 共享,请使用 Add-SCLibraryShare cmdlet 将共享添加到 VMM 库。
如果在默认 VMM 库共享(MSSCVMMLibrary)下创建 Windows 文件夹,VMM 会自动扫描共享,发现该共享上存储的所有现有对象,这些现有对象符合库对象条件,并将库对象添加到库中。 但是,可以使用 Read-SCLibraryShare cmdlet 手动刷新共享并将其内容导入 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。
第二个命令将库共享对象添加到名为 AllVHD 的库中(位于 LibraryServer01 上的 Windows 共享)。 此示例假定 LibraryServer01 已是 VMM 库服务器。
示例 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。
第二个命令将字符串“\LibraryServer01\AllVHDs”和“\LibraryServer01\AllSOs”存储在$SharePaths变量中。 此示例假定 LibraryServer01 已是 VMM 库服务器。
最后一个命令使用 ForEach 循环将存储在 $SharePaths 中的两个共享名称传递给 Add-SCLibraryShare cmdlet,该 cmdlet 会将每个 Windows 共享作为库共享添加到 VMM。
注意:有关标准 Windows PowerShell ForEach 循环语句的详细信息,请键入 Get-Help about_ForEach
。
forEach 循环语句
参数
-AddDefaultResources
指示添加了库共享的默认资源。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Credential
指定凭据对象,或者,对于某些 cmdlet,一个运行方式帐户对象,该对象包含有权执行此操作的帐户的用户名和密码。 或者,如果 Restart-SCJob,则有权完成重启的任务。
有关 PSCredential 对象的详细信息,请键入 Get-Help Get-Credential
。
有关运行方式帐户的详细信息,请键入 Get-Help New-SCRunAsAccount
。
类型: | PSCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Description
指定库共享的说明。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-JobGroup
指定一系列命令的标识符,该命令将在包含相同作业组标识符的最终命令运行之前作为集运行。
类型: | Guid |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-JobVariable
指定在此参数命名的变量中跟踪和存储作业进度。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-PROTipID
指定触发此操作的性能和资源优化提示(PRO 提示)的 ID。 此参数允许你审核 PRO 提示。
类型: | Guid |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-RunAsynchronously
指示作业以异步方式运行,以便控件立即返回到命令行界面。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SharePath
指定使用通用命名约定 (UNC) 路径的现有库服务器上的有效库共享的路径。
示例格式:-SharePath "\\LibServer01\LibShare"
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-UseAlternateDataStream
指定是否使用 Use AlternateDataStream。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-VMMServer
指定 VMM 服务器对象。
类型: | ServerConnection |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
输出
LibraryShare
此 cmdlet 返回 LibraryShare 对象。