Delen via


Add-SCLibraryShare

Hiermee voegt u Windows-shares toe aan het bestandssysteem van een bibliotheekserver aan de VMM-bibliotheek als bibliotheekshares.

Syntax

Add-SCLibraryShare
   [-VMMServer <ServerConnection>]
   [-SharePath] <String>
   [-Credential <PSCredential>]
   [-Description <String>]
   [-AddDefaultResources]
   [-JobGroup <Guid>]
   [-UseAlternateDataStream <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

De cmdlet Add-SCLibraryShare voegt Windows-shares toe op het bestandssysteem van een bibliotheekserver aan de VMM-bibliotheek (Virtual Machine Manager) als bibliotheekshares.

Voordat u een bibliotheekshare kunt toevoegen aan de VMM-bibliotheek, moet u eerst de share maken in het Windows-bestandssysteem. U kunt bijvoorbeeld Windows Verkenner gebruiken om een map te maken en te delen die u wilt toevoegen aan de bibliotheek.

Als u een Windows-share op hetzelfde niveau maakt als de standaardbibliotheekshare (MSSCVMMLibrary) die is gemaakt door VMM Setup of op een afzonderlijke bibliotheekserver, gebruikt u de cmdlet Add-SCLibraryShare om die share toe te voegen aan de VMM-bibliotheek.

Als u een Windows-map maakt onder de standaard-VMM-bibliotheekshare (MSSCVMMLibrary), scant VMM de share automatisch, detecteert alle bestaande objecten die zijn opgeslagen op die share die in aanmerking komen als bibliotheekobjecten en voegt de bibliotheekobjecten toe aan de bibliotheek. U kunt echter de cmdlet Read-SCLibraryShare gebruiken om die share handmatig te vernieuwen en de inhoud ervan te importeren in de VMM-bibliotheek.

Opmerking: Bibliotheekresources die alleen kunnen worden gedetecteerd door de bibliotheekvernieuwer, maar niet door een beheerder zijn gemaakt, omvatten virtuele harde schijven (Windows-vhd-bestanden, VHD-bestanden op basis van Citrix XenServer of VMware-gebaseerde VMDK-bestanden), virtuele diskettes (Op Windows gebaseerde .vfd-bestanden of VMware-gebaseerde .flp-bestanden), ISO-installatiekopieën (.iso-bestanden) en scripts.

Voorbeelden

Voorbeeld 1: Een Windows-share toevoegen als bibliotheekshareobject aan de VMM-bibliotheek

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Add-SCLibraryShare -SharePath "\\LibraryServer01\AllVHDs"

De eerste opdracht maakt verbinding met VMMServer01.

Met de tweede opdracht wordt een bibliotheekshareobject toegevoegd aan de bibliotheek met de naam AllVHD's (een Windows-share op LibraryServer01). In dit voorbeeld wordt ervan uitgegaan dat LibraryServer01 al een VMM-bibliotheekserver is.

Voorbeeld 2: Twee Windows-shares toevoegen als bibliotheekshareobjecten aan de VMM-bibliotheek

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 }

De eerste opdracht maakt verbinding met VMMServer1.

Met de tweede opdracht worden de tekenreeksen '\LibraryServer01\AllVHD's' en '\LibraryServer01\AllSOs' opgeslagen in de variabele $SharePaths. In dit voorbeeld wordt ervan uitgegaan dat LibraryServer01 al een VMM-bibliotheekserver is.

De laatste opdracht maakt gebruik van een ForEach-lus om de twee sharenamen die zijn opgeslagen in $SharePaths door te geven aan de cmdlet Add-SCLibraryShare, waarmee elke Windows-share wordt toegevoegd als bibliotheekshare aan VMM.

Opmerking: Typ voor meer informatie over de standaard-Windows PowerShell ForEach-lusinstructie Get-Help about_ForEach. De ForEach-lusinstructie is niet hetzelfde als de ForEach-Object cmdlet, die ForEach als alias gebruikt.

Parameters

-AddDefaultResources

Geeft aan dat de standaardbronnen voor een bibliotheekshare worden toegevoegd.

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

-Credential

Hiermee geeft u een referentieobject of, voor sommige cmdlets, een Uitvoeren als-accountobject met de gebruikersnaam en het wachtwoord van een account dat gemachtigd is om deze actie uit te voeren. Of, in het geval van Restart-SCJob, is gemachtigd om een opnieuw opgestarte taak te voltooien.

Typ voor meer informatie over het PSCredential-objectGet-Help Get-Credential.

Typ voor meer informatie over Uitvoeren als-accounts Get-Help New-SCRunAsAccount.

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

-Description

Hiermee geeft u een beschrijving voor de bibliotheekshare.

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

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set vlak voor de laatste opdracht die dezelfde taakgroep-id bevat.

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

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

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

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

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

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

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

-SharePath

Hiermee geeft u een pad naar een geldige bibliotheekshare op een bestaande bibliotheekserver die gebruikmaakt van een UNC-pad (Universal Naming Convention).

Voorbeeldindeling: -SharePath "\\LibServer01\LibShare"

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

-UseAlternateDataStream

Hiermee geeft u op of u de AlternateDataStream gebruiken al dan niet wilt gebruiken.

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

Uitvoerwaarden

LibraryShare

Met deze cmdlet wordt een LibraryShare-object geretourneerd.