Delen via

Remove-SCLibraryServer

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een bibliotheekserver uit VMM.

Syntaxis

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

Description

De Remove-SCLibraryServer cmdlet verwijdert een bibliotheekserverobject (en alle bibliotheekobjecten op die bibliotheekserver) uit de Virtual Machine Manager-database (VMM). Bibliotheekobjecten met een bijbehorend bestand (zoals .vhd- of .vmdk-bestanden) die zijn opgeslagen in het bestandssysteem van de server, worden niet verwijderd uit het bestandssysteem door deze cmdlet.

Deze cmdlet werkt als volgt:

  • Als deze bibliotheekserver ook de VMM-server is, kunt u de bibliotheekserver niet verwijderen, zodat de bewerking bibliotheekserver verwijderen mislukt.

  • Als deze computer zowel een bibliotheekserver als een host is, verwijdert deze cmdlet alleen de bibliotheekserverfunctie uit VMM, maar blijft de computer functioneren als host.

  • Als deze computer alleen een bibliotheekserver is (niet ook een host of een VMM-server), wordt de bibliotheekserver verwijderd uit VMM.

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

Voorbeelden

Voorbeeld 1: Een bibliotheekserverobject verwijderen uit 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

Met de eerste opdracht wordt u om referenties gevraagd. Wanneer het dialoogvenster wordt weergegeven, typt u de gebruikersnaam en het wachtwoord voor een lokaal Administrator-account of een domeinaccount met beheerdersrechten op de bibliotheekserver.

Met de tweede opdracht wordt het bibliotheekserverobject LibraryServer01 op VMMServer01 opgehaald en opgeslagen in de $LibServ variabele.

Met de derde opdracht verwijdert u het bibliotheekserverobject en alle bibliotheekshares op deze server uit de VMM-bibliotheek. Wanneer de cmdlet Remove-SCLibraryServer wordt gebruikt met de parameter LibraryServer, zoals in dit voorbeeld wordt weergegeven, kunt u slechts één bibliotheekserverobject doorgeven aan de cmdlet.

Voorbeeld 2: Meerdere bibliotheekserverobjecten verwijderen die een specifieke tekenreeks in hun naam hebben

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

Met de eerste opdracht wordt u om referenties gevraagd. Wanneer het dialoogvenster wordt weergegeven, typt u de gebruikersnaam en het wachtwoord voor een lokaal Administrator-account of een domeinaccount met beheerdersrechten op de bibliotheekserver.

Met de tweede opdracht worden alle bibliotheekserverobjecten opgehaald uit VMMServer01 met namen die de tekenreeks LibraryServer bevatten en worden de geretourneerde objecten opgeslagen in de $LibServers variabele (een objectmatrix).

Met de derde opdracht wordt elk bibliotheekserverobject in $LibServers doorgegeven aan Remove-SCLibraryServer, waardoor elk object uit VMM wordt verwijderd.

Voorbeeld 3: Een maximaal beschikbare bibliotheekserver en alle bijbehorende knooppunten verwijderen

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}

De eerste opdracht maakt gebruik van Get-Credential om u te vragen om een gebruikersnaam en wachtwoord op te geven en uw referenties op te slaan in $Credential. De vereiste referenties voor deze bewerking zijn een lokaal Administrator-account of een domeinaccount met beheerdersrechten op de bibliotheekserver. De volgende opdrachten gebruiken $Credential om uw referenties door te geven aan elke cmdlet waarvoor referenties zijn vereist.

De tweede opdracht maakt gebruik van de cmdlet Find-SCCluster om te bevestigen dat HAFileServer01 een maximaal beschikbare bestandsserver is en het clusterobject opslaat in de $Cluster variabele.

Met de derde opdracht wordt de maximaal beschikbare bestandsserver verwijderd (door de naam ervan op te geven) als bibliotheekserver van VMM. De opdracht maakt gebruik van de RunAsynchronly parameter om direct het besturingselement terug te keren naar de shell (voordat deze opdracht is voltooid) omdat de laatste opdracht niet hoeft te wachten totdat deze opdracht is voltooid.

De laatste opdracht maakt gebruik van een ForEach- lus om elk object dat is opgeslagen in $Cluster.ClusterNodes door te geven aan de cmdlet Remove-SCLibraryServer, waarmee elk knooppunt uit VMM wordt verwijderd. De opdracht maakt gebruik van de RunAsynchronly parameter om het besturingselement onmiddellijk terug te keren naar de shell. Typ Get-Help Add-LibraryServer -Detailedvoor meer informatie over bibliotheekservers. Typ Get-Help about_ForEachvoor meer informatie over de instructie Van Windows PowerShell ForEach loop.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een referentieobject of, voor sommige cmdlets, een Uitvoeren als-accountobject met de gebruikersnaam en het wachtwoord van een account dat is gemachtigd om deze actie uit te voeren. Of, in het geval van Restart-SCJob, is gemachtigd om een opnieuw gestarte taak te voltooien.

Typ Get-Help Get-Credentialvoor meer informatie over het object PSCredential.

Typ Get-Help New-SCRunAsAccountvoor meer informatie over Uitvoeren als-accounts.

Type:VMMCredential
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LibraryServer

Hiermee geeft u een VMM-bibliotheekserverobject.

Type:LibraryServer
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False