Add-SCLibraryShare
Fügt windows-Freigaben im Dateisystem eines Bibliotheksservers zur VMM-Bibliothek als Bibliotheksfreigaben hinzu.
Syntax
Add-SCLibraryShare
[-VMMServer <ServerConnection>]
[-SharePath] <String>
[-Credential <PSCredential>]
[-Description <String>]
[-AddDefaultResources]
[-JobGroup <Guid>]
[-UseAlternateDataStream <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Beschreibung
Das Cmdlet Add-SCLibraryShare fügt Windows-Freigaben im Dateisystem eines Bibliotheksservers zur VMM-Bibliothek (Virtual Machine Manager) als Bibliotheksfreigaben hinzu.
Bevor Sie der VMM-Bibliothek eine Bibliotheksfreigabe hinzufügen können, müssen Sie zuerst die Freigabe im Windows-Dateisystem erstellen. Sie können z. B. Den Windows-Explorer verwenden, um einen Ordner zu erstellen und zu teilen, den Sie der Bibliothek hinzufügen möchten.
Wenn Sie eine Windows-Freigabe auf derselben Ebene wie die standardbibliotheksfreigabe (MSSCVMMLibrary) erstellen, die von VMM Setup oder auf einem separaten Bibliotheksserver erstellt wurde, verwenden Sie das Cmdlet Add-SCLibraryShare, um diese Freigabe der VMM-Bibliothek hinzuzufügen.
Wenn Sie einen Windows-Ordner unter der Standard-VMM-Bibliotheksfreigabe (MSSCVMMLibrary) erstellen, überprüft VMM automatisch die Freigabe, ermittelt alle vorhandenen Objekte, die auf dieser Freigabe gespeichert sind, die als Bibliotheksobjekte gelten, und fügt die Bibliotheksobjekte der Bibliothek hinzu. Sie können jedoch das Cmdlet Read-SCLibraryShare verwenden, um diese Freigabe manuell zu aktualisieren und deren Inhalt in die VMM-Bibliothek zu importieren.
Hinweis: Bibliotheksressourcen, die nur von der Bibliotheksaktualisierung ermittelt werden können, aber nicht von einem Administrator erstellt werden können, umfassen virtuelle Festplatten (Windows-basierte VHD-Dateien, Citrix XenServer-basierte VHD-Dateien oder VMware-basierte VMDK-Dateien), virtuelle Diskettendatenträger (Windows-basierte VFD-Dateien oder VMware-basierte FLP-Dateien), ISO-Images (.iso Dateien) und Skripts.
Beispiele
Beispiel 1: Hinzufügen einer Windows-Freigabe als Bibliotheksfreigabeobjekt zur VMM-Bibliothek
PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Add-SCLibraryShare -SharePath "\\LibraryServer01\AllVHDs"Der erste Befehl stellt eine Verbindung mit VMMServer01 bereit.
Mit dem zweiten Befehl wird der Bibliothek mit dem Namen AllVHDs (eine Windows-Freigabe auf LibraryServer01) ein Bibliotheksfreigabeobjekt hinzugefügt. In diesem Beispiel wird davon ausgegangen, dass LibraryServer01 bereits ein VMM-Bibliotheksserver ist.
Beispiel 2: Hinzufügen von zwei Windows-Freigaben als Bibliotheksfreigabeobjekte zur VMM-Bibliothek
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 }Der erste Befehl stellt eine Verbindung mit VMMServer1 bereit.
Der zweite Befehl speichert die Zeichenfolgen "\LibraryServer01\AllVHDs" und "\LibraryServer01\AllSOs" in der $SharePaths Variablen. In diesem Beispiel wird davon ausgegangen, dass LibraryServer01 bereits ein VMM-Bibliotheksserver ist.
Der letzte Befehl verwendet eine ForEach- Schleife, um die beiden in $SharePaths gespeicherten Freigabenamen an das Cmdlet Add-SCLibraryShare zu übergeben, das jede Windows-Freigabe als Bibliotheksfreigabe zu VMM hinzufügt.
Hinweis: Geben Sie Get-Help about_ForEachein, um weitere Informationen zur standardmäßigen Windows PowerShell-ForEach--Loop-Anweisung zu erfahren.
Die ForEach--Loop-Anweisung ist nicht mit dem cmdlet ForEach-Object identisch, das ForEach- als Alias verwendet.
Parameter
-AddDefaultResources
Gibt an, dass die Standardressourcen für eine Bibliotheksfreigabe hinzugefügt werden.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Credential
Gibt ein Anmeldeinformationsobjekt oder für einige Cmdlets ein Run As-Kontoobjekt an, das den Benutzernamen und das Kennwort eines Kontos enthält, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Oder hat im Falle von Restart-SCJob-die Berechtigung, eine neu gestartete Aufgabe abzuschließen.
Wenn Sie weitere Informationen zum PSCredential--Objekt erhalten möchten, geben Sie Get-Help Get-Credentialein.
Wenn Sie weitere Informationen zu "Als Konten ausführen" wünschen, geben Sie Get-Help New-SCRunAsAccountein.
| Typ: | PSCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Gibt eine Beschreibung für die Bibliotheksfreigabe an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-JobGroup
Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.
| Typ: | Guid |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-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 |
-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 |
-SharePath
Gibt einen Pfad zu einer gültigen Bibliotheksfreigabe auf einem vorhandenen Bibliotheksserver an, der einen UNC-Pfad (Universal Naming Convention) verwendet.
Beispielformat: -SharePath "\\LibServer01\LibShare"
| Typ: | String |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseAlternateDataStream
Gibt an, ob "AlternateDataStream verwenden" verwendet werden soll.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
| Typ: | ServerConnection |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
Ausgaben
LibraryShare
Dieses Cmdlet gibt ein LibraryShare-Objekt zurück.