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 Add-SCLibraryShare-Cmdlet 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 die Freigabe im Windows-Dateisystem erstellen. Sie können beispielsweise mithilfe von Windows-Explorer einen Ordner erstellen und freigeben, den Sie der Bibliothek hinzufügen möchten.
Wenn Sie eine Windows-Freigabe auf derselben Ebene wie die Standardbibliotheksfreigabe (MSSCSCVMMLibrary) erstellen, die von VMM Setup oder auf einem separaten Bibliotheksserver erstellt wurde, verwenden Sie das Add-SCLibraryShare-Cmdlet , um diese Freigabe zur VMM-Bibliothek hinzuzufügen.
Wenn Sie einen Windows-Ordner unter der Standard-VMM-Bibliotheksfreigabe (MSSCVMMLibrary) erstellen, überprüft VMM automatisch die Freigabe, erkennt 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 den Inhalt in die VMM-Bibliothek zu importieren.
Hinweis: Bibliotheksressourcen, die nur von der Bibliotheksaktualisierung gefunden 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 Floppy-Datenträ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 verbindet sich mit VMMServer01.
Der zweite Befehl fügt dem Bibliotheksfreigabeobjekt "AllVHDs" (eine Windows-Freigabe auf LibraryServer01) hinzu. 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 }Mit dem ersten Befehl wird eine Verbindung mit "VMMServer1" hergestellt.
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 in $SharePaths gespeicherten Freigabenamen an das Add-SCLibraryShare-Cmdlet zu übergeben, das jede Windows-Freigabe als Bibliotheksfreigabe zu VMM hinzufügt.
Hinweis: Weitere Informationen zur Standard-Windows PowerShell ForEach-Loop-Anweisung geben Sie einGet-Help about_ForEach.
Die ForEach-Schleifen-Anweisung entspricht nicht dem cmdlet ForEach-Object, das ForEach als Alias verwendet.
Parameter
-AddDefaultResources
Gibt an, dass die Standardressourcen für eine Bibliotheksfreigabe hinzugefügt werden.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Gibt ein Anmeldeinformationenobjekt 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 im Falle von Neustart-SCJob hat die Berechtigung zum Abschließen einer neu gestarteten Aufgabe.
Weitere Informationen zum PSCredential-Objekt geben Sie Get-Help Get-Credentialein.
Geben Sie Get-Help New-SCRunAsAccountweitere Informationen zu "Ausführen als Konten" ein.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Gibt eine Beschreibung für die Bibliotheksfreigabe an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz unmittelbar vor dem letzten Befehl, der den gleichen Auftragsgruppenbezeichner enthält, ausgeführt werden.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SharePath
Gibt einen Pfad zu einer Bibliotheksfreigabe auf einem vorhandenen Bibliothekserver an, für den ein UNC-Pfad (Universal Naming Convention) verwendet wird.
Beispielformat: -SharePath "\\LibServer01\LibShare"
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseAlternateDataStream
Gibt an, ob der Use AlternateDataStream verwendet werden soll.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Ausgaben
LibraryShare
Dieses Cmdlet gibt ein LibraryShare-Objekt zurück.