Freigeben über

Remove-SCLibraryShare

  • Referenz
Modul:
VirtualMachineManager

Entfernt eine Bibliotheksfreigabe aus VMM, löscht die Freigabe jedoch nicht aus dem Windows-Dateisystem.

Syntax

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

Beschreibung

Das Cmdlet Remove-SCLibraryShare entfernt eine Bibliotheksfreigabe aus der VMM-Bibliothek (Virtual Machine Manager). Mit diesem Cmdlet werden keine Freigaben oder Dateien aus dem Dateisystem auf dem Computer entfernt.

Dieses Cmdlet gibt das Objekt nach Erfolg zurück (mit der Eigenschaft MarkedForDeletion auf $True festgelegt) oder eine Fehlermeldung beim Fehler zurück.

Beispiele

Beispiel 1: Entfernen eines Bibliotheksfreigabeobjekts aus der VMM-Bibliothek

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

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

Der zweite Befehl entfernt das Bibliotheksfreigabeobjekt und alle Bibliotheksobjekte in dieser Freigabe aus der VMM-Bibliothek, löscht jedoch nicht die Freigabe oder deren Inhalte aus dem Dateisystem auf dem Bibliotheksserver.

Beispiel 2: Entfernen mehrerer Bibliotheksfreigabeobjekte aus der VMM-Bibliothek

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

Der erste Befehl ruft alle Bibliotheksfreigabeobjekte auf LibraryServer01 ab, deren Name die Zeichenfolge "vhd" aus der VMM-Bibliothek auf VMMServer01 enthält und diese Freigabeobjekte dann in der $LibShares Variablen (ein Objektarray) speichert.

Der zweite Befehl übergibt jedes Bibliotheksfreigabeobjekt in $LibShares an Remove-SCLibraryShare. Das Cmdlet entfernt jedes der Bibliotheksfreigabeobjekte und alle Objekte in der Freigabe aus der VMM-Bibliothek, löscht jedoch nicht die entsprechenden Freigaben oder deren Inhalte aus dem Dateisystem auf dem Bibliotheksserver.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-LibraryShare

Gibt ein VMM-Bibliotheksfreigabeobjekt an.

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

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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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