Delen via

Remove-SCLibraryShare

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een bibliotheekshare uit VMM, maar verwijdert u de share niet uit het Windows-bestandssysteem.

Syntax

Remove-SCLibraryShare
      [-LibraryShare] <LibraryShare>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De cmdlet Remove-SCLibraryShare verwijdert een bibliotheekshare uit de VMM-bibliotheek (Virtual Machine Manager). Met deze cmdlet worden geen shares of bestanden uit het bestandssysteem op de computer verwijderd.

Deze cmdlet retourneert het object bij succes (waarbij de eigenschap MarkedForDeletion is ingesteld op $True) of retourneert een foutbericht bij een fout.

Voorbeelden

Voorbeeld 1: Een bibliotheekshareobject verwijderen uit de VMM-bibliotheek

PS C:\> $LibShare = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AllVHDs" }
PS C:\> Remove-SCLibraryShare -LibraryShare $LibShare

Met de eerste opdracht wordt het bibliotheekshareobject met de naam AllVHD's op LibraryServer01 opgehaald uit de VMM-bibliotheek op VMMServer01 en wordt het object vervolgens opgeslagen in de $LibShare variabele.

Met de tweede opdracht verwijdert u het bibliotheekshareobject en alle bibliotheekobjecten in deze share uit de VMM-bibliotheek, maar wordt de share of de inhoud ervan niet verwijderd uit het bestandssysteem op de bibliotheekserver.

Voorbeeld 2: Meerdere bibliotheekshareobjecten verwijderen uit de VMM-bibliotheek

PS C:\> $LibShares = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "vhd" }
PS C:\> $LibShares | Remove-SCLibraryShare

Met de eerste opdracht worden alle bibliotheekshareobjecten op LibraryServer01 opgehaald waarvan de naam de tekenreeks 'vhd' bevat uit de VMM-bibliotheek op VMMServer01 en slaat u deze shareobjecten vervolgens op in de $LibShares variabele (een objectmatrix).

Met de tweede opdracht wordt elk bibliotheekshareobject in $LibShares doorgegeven aan Remove-SCLibraryShare. Met de cmdlet worden alle bibliotheekshareobjecten en alle objecten in de share verwijderd uit de VMM-bibliotheek, maar worden de bijbehorende shares of de inhoud ervan niet verwijderd uit het bestandssysteem op de bibliotheekserver.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-LibraryShare

Hiermee geeft u een VMM-bibliotheekshareobject op.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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