Freigeben über

Remove-SCLibraryServer

  • Referenz
Modul:
VirtualMachineManager

Entfernt einen Bibliotheksserver aus VMM.

Syntax

Remove-SCLibraryServer
      [-LibraryServer] <LibraryServer>
      -Credential <VMMCredential>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-SCLibraryServer entfernt ein Bibliotheksserverobjekt (und alle Bibliotheksobjekte auf diesem Bibliotheksserver) aus der VMM-Datenbank (Virtual Machine Manager). Bibliotheksobjekte, für die im Dateisystem des Servers eine entsprechende Datei gespeichert ist (beispielsweise VHD- oder VMDK-Dateien), werden von diesem Cmdlet nicht aus dem Dateisystem entfernt.

Dieses Cmdlet funktioniert wie folgt:

  • Wenn dieser Bibliotheksserver auch der VMM-Server ist, können Sie den Bibliotheksserver nicht entfernen, sodass der Vorgang des Entfernens des Bibliotheksservers fehlschlägt.

  • Wenn dieser Computer sowohl ein Bibliotheksserver als auch ein Host ist, entfernt dieses Cmdlet nur das Bibliotheksserverfeature von VMM, aber der Computer funktioniert weiterhin als Host.

  • Wenn dieser Computer nur ein Bibliotheksserver ist (nicht auch ein Host oder ein VMM-Server), wird der Bibliotheksserver aus VMM 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 Bibliotheksserverobjekts aus VMM

PS C:\> $Creds = Get-Credential
PS C:\> $LibServ = Get-SCLibraryServer -VMMServer "VMMServer1.Contoso.com" -ComputerName "LibraryServer01.Contoso.com"
PS C:\> Remove-SCLibraryServer -LibraryServer $LibServ -Credential $Creds

Der erste Befehl fordert Sie zur Eingabe von Anmeldeinformationen auf. Wenn das Dialogfeld angezeigt wird, geben Sie den Benutzernamen und das Kennwort für ein lokales Administratorkonto oder ein Domänenkonto mit Administratorrechten auf dem Bibliotheksserver ein.

Der zweite Befehl ruft das Bibliotheksserverobjekt "LibraryServer01" auf VMMServer01 ab und speichert es in der $LibServ Variablen.

Der dritte Befehl entfernt das Bibliotheksserverobjekt und alle Bibliotheksfreigaben auf diesem Server aus der VMM-Bibliothek. Wenn das Cmdlet Remove-SCLibraryServer mit dem Parameter LibraryServer verwendet wird, wie in diesem Beispiel gezeigt, können Sie nur ein Bibliotheksserverobjekt an das Cmdlet übergeben.

Beispiel 2: Entfernen mehrerer Bibliotheksserverobjekte mit einer bestimmten Zeichenfolge in ihrem Namen

PS C:\> $Creds = Get-Credential
PS C:\> $LibServers = Get-SCLibraryServer -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "LibraryServer" }
PS C:\> $LibServers | Remove-SCLibraryServer -Credential $Creds

Der erste Befehl fordert Sie zur Eingabe von Anmeldeinformationen auf. Wenn das Dialogfeld angezeigt wird, geben Sie den Benutzernamen und das Kennwort für ein lokales Administratorkonto oder ein Domänenkonto mit Administratorrechten auf dem Bibliotheksserver ein.

Der zweite Befehl ruft alle Bibliotheksserverobjekte von VMMServer01 mit Namen ab, die die Zeichenfolge "LibraryServer" enthalten und die zurückgegebenen Objekte in der $LibServers Variablen (ein Objektarray) speichert.

Der dritte Befehl übergibt jedes Bibliotheksserverobjekt in $LibServers an Remove-SCLibraryServer, das jedes Objekt aus VMM entfernt.

Beispiel 3: Entfernen eines hoch verfügbaren Bibliotheksservers und aller knoten

PS C:\> $Credential = Get-Credential
PS C:\> $Cluster = Find-SCCluster -ComputerName "HAFileServer01.Contoso.com" -Credential $Credential
PS C:\> Remove-LibraryServer -LibraryServer "HAFileServer01.Contoso.com" -Credential $Credential -RunAsynchronously
PS C:\> ForEach ($Node in $Cluster.ClusterNodes) {Remove-LibraryServer -LibraryServer $Node -Credential $Credential -RunAsynchronously}

Der erste Befehl verwendet Get-Credential , um Sie aufzufordern, einen Benutzernamen und ein Kennwort anzugeben und Ihre Anmeldeinformationen in $Credential zu speichern. Für diesen Vorgang sind als Anmeldeinformationen entweder ein lokales Administratorkonto oder ein Domänenkonto mit Administratorrechten auf dem Bibliothekserver erforderlich. Mit den folgenden Befehlen werden über "$Credential" die Anmeldeinformationen an jedes Cmdlet übergeben, für das Anmeldeinformationen erforderlich sind.

Der zweite Befehl verwendet das Cmdlet Find-SCCluster , um zu bestätigen, dass HAFileServer01 ein hoch verfügbarer Dateiserver ist und das Clusterobjekt in der $Cluster Variablen speichert.

Der dritte Befehl entfernt den hoch verfügbaren Dateiserver (durch Angabe seines Namens) als Bibliotheksserver von VMM. Der Befehl verwendet den RunAsynchronly-Parameter , um die Steuerung sofort an die Shell zurückzugeben (bevor dieser Befehl abgeschlossen ist), da der letzte Befehl erst nach Abschluss dieses Befehls warten muss.

Der letzte Befehl verwendet eine ForEach-Schleife , um jedes In $Cluster.ClusterNodes gespeicherte Objekt an das Cmdlet Remove-SCLibraryServer zu übergeben, das jeden Knoten aus VMM entfernt. Der Befehl verwendet den RunAsynchronly-Parameter , um die Steuerung sofort an die Shell zurückzugeben. Wenn Sie weitere Informationen zu Bibliotheksservern benötigen, geben Sie den Typ Get-Help Add-LibraryServer -Detailed. Weitere Informationen zur Windows PowerShell ForEach Loop-Anweisung geben Sie Get-Help about_ForEachein.

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

-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 im Falle von Restart-SCJob hat die Berechtigung zum Abschließen einer neu gestarteten Aufgabe.

Geben Sie weitere Informationen zum PSCredential-Objekt ein Get-Help Get-Credential.

Weitere Informationen zum Ausführen als Konten geben Sie Get-Help New-SCRunAsAccount.

Type:VMMCredential
Position:Named
Default value:None
Required:True
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

-LibraryServer

Gibt ein VMM-Bibliothekserverobjekt an.

Type:LibraryServer
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