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 循环语句 与 ForEach-Object cmdlet 不同,该 cmdlet 使用 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 对象。