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) 库作为库共享。

将库共享添加到 VMM 库之前,必须先在 Windows 文件系统中创建共享。 例如,您可以使用 Windows 资源管理器来创建和共享要添加到库中的文件夹。

如果在与默认库共享相同的级别创建 Windows 共享, (VMM 安装程序创建的 MSSCVMMLibrary) ,请使用 Add-SCLibraryShare cmdlet 将共享添加到 VMM 库。

如果在默认 VMM 库共享下创建 Windows 文件夹 (MSSCVMMLibrary) ,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_ForEachForEach 循环语句与使用 ForEach 作为别名的 ForEach-Object cmdlet 不同。

参数

-AddDefaultResources

指示添加库共享的默认资源。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

指定凭据对象,或者,对于某些 cmdlet,一个运行方式帐户对象,该对象包含有权执行此操作的帐户的用户名和密码。 或者,在 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

指示作业以异步方式运行,以便控件立即返回到命令 shell。

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

指定是否使用 Use 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

此 cmdlet 返回 LibraryShare 对象。