Read-SCLibraryShare

汇报存储在库共享中的 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

第一个命令使用字符串“vhd”获取 LibraryServer01 上的库共享对象,然后将对象存储在$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

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

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

-LibraryShare

指定 VMM 库共享对象。

Type:LibraryShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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\]"
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

输出

LibraryShare

此 cmdlet 返回 LibraryShare 对象。