Freigeben über

Read-SCLibraryShare

  • Referenz
Modul:
VirtualMachineManager

Aktualisiert den Zustand und die Metadaten von VMM-Bibliotheksobjekten, die in einer Bibliotheksfreigabe gespeichert sind.

Syntax

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

Beschreibung

Das cmdlet Read-SCLibraryShare aktualisiert den Status und die Metadaten aller VMM-Bibliotheksobjekte (Virtual Machine Manager), die in der angegebenen Bibliotheksfreigabe gespeichert sind. Dieses Update findet auch neue Bibliotheksdateien in der angegebenen Bibliotheksfreigabe sowie neue untergeordnete freigegebene Ordner unter der angegebenen Bibliotheksfreigabe.

Beispiele

Beispiel 1: Aktualisieren einer angegebenen Bibliotheksfreigabe

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

Der erste Befehl ruft das Bibliotheksfreigabeobjekt mit dem Namen AllVHDs auf LibraryServer01 aus der VMM-Bibliothek auf VMMServer01 ab und speichert das Objekt dann in der $LibShare Variablen.

Der zweite Befehl aktualisiert die Status- und Metadateninformationen für alle Bibliotheksobjekte in der in $LibShare gespeicherten Freigabe und fügt dann alle neuen Bibliotheksobjekte hinzu, die in der Freigabe zur VMM-Bibliothek enthalten sind.

Beispiel 2: Aktualisieren mehrerer Bibliotheksfreigaben

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

Der erste Befehl ruft die Bibliotheksfreigabeobjekte auf LibraryServer01 mit der Zeichenfolge "vhd" in ihren Namen ab und speichert dann die Objekte in der $LibShares Variablen.

Der zweite Befehl aktualisiert die Informationen für alle bibliotheksfreigaben, die in $LibShares gespeichert sind, und fügt dann alle neuen Bibliotheksobjekte hinzu, die in diesen Freigaben enthalten sind, der VMM-Bibliothek.

Beispiel 3: Aktualisieren eines bestimmten Unterverzeichnisses in einer Bibliotheksfreigabe

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"

Der erste Befehl ruft das Bibliotheksfreigabeobjekt mit dem Namen AllVHDs auf LibraryServer01 aus der VMM-Bibliothek auf VMMServer01 ab und speichert das Objekt dann in der $LibShare Variablen.

Der zweite Befehl aktualisiert die Status- und Metadateninformationen für alle Bibliotheksobjekte im angegebenen Unterverzeichnis in der Bibliotheksfreigabe, die in $LibShare gespeichert ist, und fügt dann alle neuen Bibliotheksobjekte hinzu, die in der Freigabe der VMM-Bibliothek gefunden wurden.

Parameter

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LibraryShare

Gibt ein VMM-Bibliotheksfreigabeobjekt an.

Typ:LibraryShare
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Zielpfad für den Vorgang an.

Beispielformate:

  • Lokaler Pfad: -Path "F:\"
  • UNC-Pfad: -Path "\\Library\Templates"
  • Volume-GUID-Pfad: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • VMware ESX-Pfad: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Citrix XenServer-Pfad: -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

LibraryShare

Dieses Cmdlet gibt ein LibraryShare-Objekt zurück.