Remove-SCVMHost

Modul:

VirtualMachineManager

Tar bort en virtuell datorvärd från VMM.

Syntax

Remove-SCVMHost
      [-VMHost] <Host>
      [-VMMServer <ServerConnection>]
      [-Credential <VMMCredential>]
      [-RemoveHostWithVMs]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-SCVMHost
      [-VMHost] <Host>
      [-VMMServer <ServerConnection>]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdleten Remove-SCVMHost tar bort en eller flera virtuella datorvärdar från Virtual Machine Manager (VMM). Cmdleten Remove-SCVMHost fungerar på följande sätt:

• Endast värdserver. Om den här datorn är en Hyper-V-värd men inte också är en biblioteksserver tas värdobjektet bort från VMM-databasen och VMM-agentprogramvaran avinstalleras från den fysiska värdservern.

Om värden är en VMware ESX-värd eller en Citrix XenServer-värd tas värdobjektet bort från VMM-databasen. VMM installerar inte en agent på ESX-värdar eller XenServer-värdar.

• Värd- och biblioteksserver. Om den här datorn är en Hyper-V-värd och även är en biblioteksserver, tar det här kommandot bara bort värdfunktionerna men lämnar biblioteksserverfunktionen på plats. Värdobjektet tas alltså bort från VMM-databasen, men VMM-agentprogramvaran avinstalleras inte från den fysiska servern. Biblioteksserverobjektet finns kvar i databasen.

Om värden är en ESX-värd kan den bara fungera som en virtuell datorvärd i VMM. Det kan inte vara både en värd och en biblioteksserver.

• Autentiseringsuppgifter. Om en Hyper-V-värd är ansluten till en Active Directory-domän måste du ange autentiseringsuppgifter för ett konto med rätt behörighet för att ta bort värddatorn från VMM.

Du behöver inte ange Active Directory-autentiseringsuppgifter för att ta bort en perimeternätverksvärd, en ESX-värd eller en XenServer-värd från VMM.

• Virtual Machines. När du tar bort en värd hanteras värden inte längre av VMM. Virtuella datorer på värdservern tas dock inte bort eller kopplas bort från servern. Alla virtuella datorer som körs stängs inte av. Även om de virtuella datorerna inte längre hanteras av VMM påverkas de inte på något annat sätt.
• Framtvingad borttagning. Du kan använda force-parametern med cmdleten Remove-SCVMHost för att ta bort en virtuell datorvärd från VMM när du inte har rätt autentiseringsuppgifter för att hantera värden eller när VMM-servern inte längre kan kommunicera med den värden.

När du anger force-parametern frågar eller söker VMM inte efter autentiseringsuppgifter och VMM försöker inte heller ansluta till värden och avinstallera VMM-agenten. Därför rekommenderas endast användning av force-parametern när du tar bort inaktuella värdposter från VMM-databasen.

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 en specifik domänansluten värd från VMM

PS C:\> $Credential = Get-Credential
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Credential $Credential -Confirm

Det första kommandot använder cmdleten Get-Credential för att uppmana dig att ange ett användarnamn och lösenord och lagra de angivna autentiseringsuppgifterna i variabeln $Credential. De autentiseringsuppgifter som krävs för den här åtgärden är ett domänkonto med administratörsbehörighet för att ta bort en Windows-baserad värdserver som är ansluten till en Active Directory-domän från VMM.

Det andra kommandot hämtar värdobjektet med namnet VMHost01 och lagrar objektet i variabeln $VMHost.

Det tredje kommandot tar bort värdobjektet som lagras i $VMHost. När det här kommandot bearbetas ger $Credential autentiseringsuppgifter till Remove-VMHost och parametern Bekräfta uppmanar dig att bekräfta att du vill ta bort värden från VMM.

Exempel 2: Ta bort alla värdar som inte är noder i ett värdkluster från VMM

PS C:\> Get-SCVMHost | where {$_.HostCluster -eq $NULL} | where {$_.VirtualizationPlatform -eq "VMwareESX" -or $_.PerimeterNetworkHost -eq 1 -or $_.NonTrustedDomainHost -eq 1} | Remove-SCVMHost -Confirm
PS C:\> $Credential = Get-Credential
PS C:\> Get-VMHost | where {$_.HostCluster -eq $NULL -and $_.VirtualizationPlatform -ne "VMwareESX" -and $_.PerimeterNetworkHost -eq 0 -and $_.NonTrustedDomainHost -eq 0} | Remove-VMHost -Credential $Credential -Confirm

Det första kommandot hämtar alla värdobjekt, exkluderar alla värdar som är noder i ett värdkluster, väljer endast de objekt som representerar VMware ESX-värdar, perimeternätverksvärdar eller icke-betrodda domänvärdar och tar sedan bort objekten från VMM om du bekräftar att du vill ta bort dem. Autentiseringsuppgifter krävs inte för att ta bort dessa värdar.

Det andra kommandot uppmanar dig att ange ett användarnamn och lösenord för ett konto med behörighet att ta bort domänanslutna Windows-värdar från VMM och lagra dina autentiseringsuppgifter i $Credential.

Det sista kommandot hämtar alla domänanslutna Windows-baserade värdobjekt som inte ingår i ett värdkluster och skickar objekten till cmdleten Remove-VMHost . När det här kommandot bearbetas ger $Credential dina autentiseringsuppgifter till Remove-VMHost, och parametern Bekräfta uppmanar dig att bekräfta att du vill ta bort dessa värdar från VMM.

Exempel 3: Ta bort en specifik värd som du inte längre kan komma åt från VMM

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Force -Confirm

Det första kommandot hämtar värdobjektet med namnet VMHost03 och lagrar objektet i variabeln $VMHost.

Det andra kommandot växlar på force-parametern för att säkerställa att VMHost03 tas bort från VMM-databasen. Autentiseringsuppgifter behövs inte för den här åtgärden. Parametern Bekräfta uppmanar dig att bekräfta att du vill ta bort den här värden.

Obs! Du kan använda parametern Force för att ta bort en värd från VMM när du inte har autentiseringsuppgifterna för den värden eller när VMM-servern inte längre kan kommunicera med den värden.

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ändarnamnet och lösenordet för ett konto som har behörighet att utföra den här åtgärden. Eller, om det gäller Restart-SCJob, har behörighet att slutföra en omstartad uppgift.

Om du vill ha mer information om PSCredential-objektet skriver du Get-Help Get-Credential.

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:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

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

-JobVariable

Anger att jobb förloppet spåras och lagras i variabeln med namnet av den här parametern.

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

-PROTipID

Anger ID för tipset om 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

-RemoveHostWithVMs

Om du vill ha mer information om PSCredential-objektet skriver du Get-Help Get-Credential.

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

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

-VMHost

Anger ett värdobjekt för en virtuell dator. VMM stöder Hyper-V-värdar, VMware ESX-värdar och Citrix XenServer-värdar.

Mer information om varje typ av värd finns i cmdleten Add-SCVMHost .

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

-VMMServer

Anger ett VMM-serverobjekt.

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
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

Relaterade länkar

• Add-SCVMHost
• Disable-SCVMHost
• Enable-SCVMHost
• Get-SCVMHost
• Move-SCVMHost
• New-SCVMHost
• Read-SCVMHost
• Register-SCVMHost
• Repair-SCVMHost
• Restart-SCVMHost
• Set-SCVMHost
• Start-SCVMHost
• Stop-SCVMHost