Dela via

Remove-SCLibraryServer

  • Referens
Modul:
VirtualMachineManager

Tar bort en biblioteksserver från VMM.

Syntax

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

Description

Cmdleten Remove-SCLibraryServer tar bort ett biblioteksserverobjekt (och alla biblioteksobjekt på den biblioteksservern) från VMM-databasen (Virtual Machine Manager). Biblioteksobjekt som har en motsvarande fil (till exempel .vhd- eller .vmdk-filer) som lagras i serverns filsystem tas inte bort från filsystemet av den här cmdleten.

Den här cmdleten fungerar på följande sätt:

  • Om den här biblioteksservern också är VMM-servern kan du inte ta bort biblioteksservern, så åtgärden ta bort biblioteksservern misslyckas.

  • Om den här datorn både är en biblioteksserver och en värd tar den här cmdleten bara bort biblioteksserverfunktionen från VMM, men datorn fortsätter att fungera som värd.

  • Om den här datorn bara är en biblioteksserver (inte även en värd eller en VMM-server) tas biblioteksservern bort från VMM.

Den här cmdleten returnerar objektet när det lyckas (med egenskapen MarkedForDeletion inställd på $True) eller returnerar ett felmeddelande vid fel.

Exempel

Exempel 1: Ta bort ett biblioteksserverobjekt från 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

Det första kommandot uppmanar dig att ange autentiseringsuppgifter. När dialogrutan visas skriver du användarnamnet och lösenordet för antingen ett lokalt administratörskonto eller ett domänkonto med administratörsbehörighet på biblioteksservern.

Det andra kommandot hämtar biblioteksserverobjektet med namnet LibraryServer01 på VMMServer01 och lagrar det i variabeln $LibServ.

Det tredje kommandot tar bort biblioteksserverobjektet och alla biblioteksresurser på den här servern från VMM-biblioteket. När cmdleten Remove-SCLibraryServer används med parametern LibraryServer , som du ser i det här exemplet, kan du bara skicka ett biblioteksserverobjekt till cmdleten.

Exempel 2: Ta bort flera biblioteksserverobjekt som har en specifik sträng i sitt namn

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

Det första kommandot uppmanar dig att ange autentiseringsuppgifter. När dialogrutan visas skriver du användarnamnet och lösenordet för antingen ett lokalt administratörskonto eller ett domänkonto med administratörsbehörighet på biblioteksservern.

Det andra kommandot hämtar alla biblioteksserverobjekt från VMMServer01 med namn som innehåller strängen "LibraryServer" och lagrar de returnerade objekten i variabeln $LibServers (en objektmatris).

Det tredje kommandot skickar varje biblioteksserverobjekt i $LibServers till Remove-SCLibraryServer, som tar bort varje objekt från VMM.

Exempel 3: Ta bort en biblioteksserver med hög tillgänglighet och alla dess noder

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}

Det första kommandot använder Get-Credential för att uppmana dig att ange ett användarnamn och lösenord och lagrar dina autentiseringsuppgifter i $Credential. De nödvändiga autentiseringsuppgifterna för den här åtgärden är antingen ett lokalt administratörskonto eller ett domänkonto med administratörsbehörighet på biblioteksservern. Följande kommandon använder $Credential för att skicka dina autentiseringsuppgifter till varje cmdlet som kräver autentiseringsuppgifter.

Det andra kommandot använder cmdleten Find-SCCluster för att bekräfta att HAFileServer01 är en filserver med hög tillgänglighet och lagrar klusterobjektet i variabeln $Cluster.

Det tredje kommandot tar bort den filserver med hög tillgänglighet (genom att ange dess namn) som en biblioteksserver från VMM. Kommandot använder parametern RunAsynchronously för att returnera kontrollen till gränssnittet omedelbart (innan det här kommandot slutförs) eftersom det sista kommandot inte behöver vänta tills kommandot har slutförts.

Det senaste kommandot använder en ForEach-loop för att skicka varje objekt som lagras i $Cluster.ClusterNodes till cmdleten Remove-SCLibraryServer , som tar bort varje nod från VMM. Kommandot använder parametern RunAsynchronously för att returnera kontrollen till gränssnittet omedelbart. Om du vill ha mer information om biblioteksservrar skriver du Get-Help Add-LibraryServer -Detailed. Mer information om Windows PowerShell ForEach-loop-instruktionen finns i .Get-Help about_ForEach

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Credential

Anger ett autentiseringsobjekt eller, för vissa cmdletar, ett Kör som-kontoobjekt som innehåller användarnamn och lösenord för ett konto som har behörighet att utföra den här åtgärden. Eller, när det gäller Restart-SCJob, har behörighet att slutföra en omstartad uppgift.

Mer information om PSCredential-objektetGet-Help Get-Credentialfinns i .

Om du vill ha mer information om Kör som-konton skriver du Get-Help New-SCRunAsAccount.

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

-JobVariable

Anger att jobbstatus spåras och lagras i variabeln som heter av den här parametern.

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

-LibraryServer

Anger ett VMM-biblioteksserverobjekt.

Type:LibraryServer
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PROTipID

Anger ID för tipset prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

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

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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