通过

Read-SCLibraryShare

  • 参考
模块:
VirtualMachineManager

更新存储在库共享中的 VMM 库对象的状态和元数据。

语法

Read-SCLibraryShare
    [-LibraryShare] <LibraryShare>
    [-Path <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

说明

Read-SCLibraryShare cmdlet 更新存储在指定库共享中的所有 Virtual Machine Manager （VMM） 库对象的状态和元数据。 此更新还会查找指定库共享上的新库文件，以及指定库共享下的新子共享文件夹。

示例

示例 1：更新指定的库共享

PS C:\> $LibShare = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AllVHDs" }
PS C:\> Read-SCLibraryShare -LibraryShare $LibShare

第一个命令从 VMMServer01 上的 VMM 库获取名为 AllVHD 的库共享对象，然后将该对象存储在$LibShare变量中。

第二个命令更新存储在$LibShare共享中的所有库对象的状态和元数据信息，然后将共享中找到的任何新库对象添加到 VMM 库。

示例 2：更新多个库共享

PS C:\> $LibShares = Get-SCLibraryShare -VMMServer "VMMServer1.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "vhd" }
PS C:\> $LibShares | Read-SCLibraryShare

第一个命令获取 LibraryServer01 上的库共享对象，其名称中包含字符串“vhd”，然后将对象存储在$LibShares变量中。

第二个命令将更新存储在$LibShares中的所有库共享的信息，然后将这些共享中找到的任何新库对象添加到 VMM 库。

示例 3：更新库共享上的特定子目录

PS C:\> $LibShare = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AllVHDs" }
PS C:\> Read-SCLibraryShare -LibraryShare $LibShare -Path "Production\WebFrontEnd"

第一个命令从 VMMServer01 上的 VMM 库获取名为 AllVHD 的库共享对象，然后将该对象存储在$LibShare变量中。

第二个命令更新存储在 $LibShare 中的库共享上指定子目录中的所有库对象的状态和元数据信息，然后将共享中找到的任何新库对象添加到 VMM 库。

参数

-JobVariable

指定在此参数命名的变量中跟踪和存储作业进度。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LibraryShare

指定 VMM 库共享对象。

类型:LibraryShare
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Path

指定操作的目标路径。

示例格式：

  • 本地路径：-Path "F:\"
  • UNC 路径：-Path "\\Library\Templates"
  • 卷 GUID 路径：-Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • VMware ESX 路径：-Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Citrix XenServer 路径：-Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
类型: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

输出

LibraryShare

此 cmdlet 返回 LibraryShare 对象。