Remove-SCVMHost

Modul:

VirtualMachineManager

Menghapus host komputer virtual dari VMM.

Sintaks

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

Deskripsi

Cmdlet Remove-SCVMHost menghapus satu atau beberapa host komputer virtual dari Virtual Machine Manager (VMM). Cmdlet Remove-SCVMHost beroperasi sebagai berikut:

• Server Host Saja. Jika komputer ini adalah host Hyper-V tetapi bukan juga server pustaka, objek host dihapus dari database VMM, dan perangkat lunak agen VMM dihapus dari server host fisik.

Jika host adalah host VMware ESX atau host Citrix XenServer, objek host dihapus dari database VMM. VMM tidak menginstal agen pada host ESX atau host XenServer.

• Server Host dan Pustaka. Jika komputer ini adalah host Hyper-V dan juga server pustaka, perintah ini hanya menghapus fungsionalitas host tetapi membiarkan fitur server pustaka di tempatnya. Artinya, objek host dihapus dari database VMM, tetapi perangkat lunak agen VMM tidak dihapus dari server fisik. Objek server pustaka tetap berada dalam database.

Jika host adalah host ESX, host hanya dapat berfungsi sebagai host komputer virtual di VMM. Ini tidak boleh berupa host dan server pustaka.

• Kredensial. Jika host Hyper-V bergabung ke domain Direktori Aktif, Anda harus memberikan kredensial untuk akun dengan izin yang sesuai untuk menghapus komputer host tersebut dari VMM.

Anda tidak perlu memberikan kredensial Direktori Aktif untuk menghapus host jaringan perimeter, host ESX, atau host XenServer dari VMM.

• Virtual Machines. Saat Anda menghapus host, host tidak lagi dikelola oleh VMM. Namun, komputer virtual apa pun di server host tidak akan dihapus atau dikaitkan dari server. Setiap komputer virtual yang berjalan tidak dimatikan. Meskipun komputer virtual tidak lagi dikelola oleh VMM, komputer virtual tidak terpengaruh dengan cara lain.
• Penghapusan Paksa. Anda dapat menggunakan parameter Paksa dengan cmdlet Remove-SCVMHost untuk menghapus host komputer virtual dari VMM ketika Anda tidak memiliki kredensial yang sesuai untuk mengelola host tersebut atau ketika server VMM tidak dapat lagi berkomunikasi dengan host tersebut.

Ketika Anda menentukan parameter Paksa , VMM tidak meminta atau memeriksa kredensial, juga tidak akan mencoba terhubung ke host dan menghapus instalan agen VMM. Oleh karena itu, menggunakan parameter Force hanya disarankan saat menghapus catatan host kedaluarsa dari database VMM.

Cmdlet ini mengembalikan objek setelah berhasil (dengan properti MarkedForDeletion diatur ke $True) atau mengembalikan pesan kesalahan setelah kegagalan.

Contoh

Contoh 1: Menghapus host tertentu yang bergabung dengan domain dari VMM

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

Perintah pertama menggunakan cmdlet Get-Credential untuk meminta Anda menyediakan nama pengguna dan kata sandi dan menyimpan kredensial yang disediakan dalam variabel $Credential. Kredensial yang diperlukan untuk operasi ini adalah akun domain dengan hak administrator untuk menghapus server host berbasis Windows yang bergabung ke domain Direktori Aktif dari VMM.

Perintah kedua mendapatkan objek host bernama VMHost01 dan menyimpan objek dalam variabel $VMHost.

Perintah ketiga menghapus objek host yang disimpan di $VMHost. Saat perintah ini diproses, $Credential menyediakan kredensial untuk Remove-VMHost, dan parameter Konfirmasi meminta Anda untuk mengonfirmasi bahwa Anda ingin menghapus host ini dari VMM.

Contoh 2: Hapus semua host yang bukan node dalam kluster host dari 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

Perintah pertama mendapatkan semua objek host, mengecualikan host apa pun yang merupakan node dalam kluster host, hanya memilih objek yang mewakili host VMware ESX, host jaringan perimeter, atau host domain yang tidak tepercaya, lalu menghapus objek tersebut dari VMM jika Anda mengonfirmasi bahwa Anda ingin menghapusnya. Kredensial tidak diperlukan untuk menghapus host ini.

Perintah kedua meminta Anda untuk memberikan nama pengguna dan kata sandi untuk akun dengan izin untuk menghapus host Windows yang bergabung dengan domain dari VMM dan menyimpan kredensial Anda di $Credential.

Perintah terakhir mendapatkan semua objek host berbasis Windows yang bergabung dengan domain yang bukan bagian dari kluster host dan meneruskan objek ke cmdlet Remove-VMHost . Saat perintah ini diproses, $Credential menyediakan kredensial Anda untuk Remove-VMHost, dan parameter Konfirmasi meminta Anda untuk mengonfirmasi bahwa Anda ingin menghapus host ini dari VMM.

Contoh 3: Menghapus host tertentu yang tidak dapat Anda akses lagi dari VMM

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

Perintah pertama mendapatkan objek host bernama VMHost03 dan menyimpan objek dalam variabel $VMHost.

Perintah kedua beralih pada parameter Force untuk memastikan bahwa VMHost03 dihapus dari database VMM. Kredensial tidak diperlukan untuk operasi ini. Parameter Konfirmasi meminta Anda untuk mengonfirmasi bahwa Anda ingin menghapus host ini.

Catatan: Anda dapat menggunakan parameter Paksa untuk menghapus host dari VMM ketika Anda tidak memiliki kredensial untuk host tersebut atau ketika server VMM tidak dapat lagi berkomunikasi dengan host tersebut.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-Credential

Menentukan objek kredensial atau, untuk beberapa cmdlet, objek akun Jalankan Sebagai yang berisi nama pengguna dan kata sandi akun yang memiliki izin untuk melakukan tindakan ini. Atau, dalam kasus Restart-SCJob, memiliki izin untuk menyelesaikan tugas yang dimulai ulang.

Untuk informasi selengkapnya tentang objek PSCredential , ketik Get-Help Get-Credential.

Untuk informasi selengkapnya tentang akun Jalankan Sebagai, ketik Get-Help New-SCRunAsAccount.

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

-Force

Memaksa perintah untuk berjalan tanpa meminta konfirmasi pengguna.

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

-JobVariable

Menentukan bahwa kemajuan pekerjaan dilacak dan disimpan dalam variabel yang dinamai oleh parameter ini.

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

-PROTipID

Menentukan ID tip Performa dan Pengoptimalan Sumber Daya (tip PRO) yang memicu tindakan ini. Parameter ini memungkinkan Anda mengaudit tips PRO.

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

-RemoveHostWithVMs

Untuk informasi selengkapnya tentang objek PSCredential , ketik Get-Help Get-Credential.

Untuk informasi selengkapnya tentang akun Jalankan Sebagai, ketik Get-Help New-SCRunAsAccount.

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

-RunAsynchronously

Menunjukkan bahwa pekerjaan berjalan secara asinkron sehingga kontrol segera kembali ke shell perintah.

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

-VMHost

Menentukan objek host komputer virtual. VMM mendukung host Hyper-V, host VMware ESX, dan host Citrix XenServer.

Untuk informasi selengkapnya tentang setiap jenis host, lihat cmdlet Add-SCVMHost .

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

-VMMServer

Menentukan objek server VMM.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Link Terkait

• 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