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 Virtual Machine Manager -Datenbank (VMM). 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 Bibliotheksservervorgang 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 (mit der Eigenschaft "MarkedForDeletion " auf $True festgelegt) zurück oder gibt eine Fehlermeldung 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 zu 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 namens LibraryServer01 auf VMMServer01 ab und speichert ihn 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 LibraryServer-Parameter verwendet wird, wie in diesem Beispiel dargestellt, 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 zu 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, der jedes Objekt aus VMM entfernt.

Beispiel 3: Entfernen eines hoch verfügbaren Bibliotheksservers und aller seiner 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 warten muss, bis dieser Befehl abgeschlossen ist.

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 Steuerung sofort an die Shell zurückzugeben. Geben Sie Get-Help Add-LibraryServer -Detailedweitere Informationen zu Bibliotheksservern ein. Weitere Informationen zur Windows PowerShell ForEach-Loop-Anweisung geben Sie einGet-Help about_ForEach.

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

-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