Remove-SCLibraryServer

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

Mit dem Cmdlet Remove-SCLibraryServer wird ein Bibliothekserverobjekt (und alle Bibliotheksobjekte auf diesem Bibliothekserver) aus der VMM-Datenbank (Virtual Machine Manager) entfernt. Bibliotheksobjekte, für die eine entsprechende Datei (z. B. VHD- oder VMDK-Dateien) im Dateisystem des Servers gespeichert ist, werden mit diesem Cmdlet nicht aus dem Dateisystem entfernt.

Dieses Cmdlet funktioniert wie folgt:

• Wenn es sich bei diesem Bibliothekserver auch um den VMM-Server handelt, können Sie den Bibliothekserver nicht entfernen, sodass der Vorgang zum Entfernen des Bibliothekservers fehlschlägt.

• Wenn es sich bei diesem Computer sowohl um einen Bibliothekserver als auch um einen Host handelt, wird mit diesem Cmdlet nur das Bibliothekserverfeature aus VMM entfernt, der Computer funktioniert jedoch weiterhin als Host.

• Wenn es sich bei diesem Computer nur um einen Bibliothekserver handelt (nicht auch um einen Host oder einen VMM-Server), wird der Bibliothekserver aus VMM entfernt.

Dieses Cmdlet gibt das Objekt bei Erfolg zurück (wobei die Eigenschaft MarkedForDeletion auf $True festgelegt ist) oder gibt eine Fehlermeldung zurück, wenn ein Fehler auftritt.

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 Bibliothekserver ein.

Mit dem zweiten Befehl wird das Bibliothekserverobjekt mit dem Namen LibraryServer01 in VMMServer01 abgerufen und in der Variablen $LibServ gespeichert.

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

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 Bibliothekserver ein.

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

Der dritte Befehl übergibt jedes Bibliothekserverobjekt in $LibServers an Remove-SCLibraryServer, wodurch jedes Objekt aus VMM entfernt wird.

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 fordert Sie mit Get-Credential auf, einen Benutzernamen und ein Kennwort einzugeben, und speichert Ihre Anmeldeinformationen in $Credential. Die erforderlichen Anmeldeinformationen für diesen Vorgang sind entweder ein lokales Administratorkonto oder ein Domänenkonto mit Administratorrechten auf dem Bibliothekserver. In den folgenden Befehlen wird $Credential verwendet, um Ihre Anmeldeinformationen an jedes Cmdlet zu übergeben, für das Anmeldeinformationen erforderlich sind.

Im zweiten Befehl wird das Cmdlet Find-SCCluster verwendet, um zu bestätigen, dass HAFileServer01 ein Dateiserver mit hoher Verfügbarkeit ist und das Clusterobjekt in der Variablen $Cluster speichert.

Mit dem dritten Befehl wird der Dateiserver mit hoher Verfügbarkeit (durch Angabe seines Namens) als Bibliothekserver aus VMM entfernt. Der Befehl verwendet den RunAsynchronously-Parameter , um die Steuerung sofort (vor Abschluss dieses Befehls) an die Shell zurückzugeben, da der letzte Befehl nicht warten muss, bis dieser Befehl abgeschlossen ist.

Im letzten Befehl wird eine ForEach-Schleife verwendet, um jedes in $Cluster.ClusterNodes gespeicherte Objekt an das Cmdlet Remove-SCLibraryServer zu übergeben, das jeden Knoten aus VMM entfernt. Der Befehl verwendet den RunAsynchronously-Parameter , um die Steuerung sofort an die Shell zurückzugeben. Weitere Informationen zu Bibliothekservern erhalten Sie, wenn Sie Get-Help Add-LibraryServer -Detailed. Weitere Informationen zur Windows PowerShell-ForEach-Schleifenanweisung geben Sie Get-Help about_ForEachein.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.