Bagikan melalui

Remove-SCVirtualNetworkAdapter

  • Referensi
Modul:
VirtualMachineManager

Menghapus objek adaptor jaringan virtual dari VMM.

Sintaks

Remove-SCVirtualNetworkAdapter
      [-VirtualNetworkAdapter] <VirtualNetworkAdapter>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCVirtualNetworkAdapter
      -SlotID <Int32>
      -JobGroup <Guid>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Deskripsi

Cmdlet Remove-SCVirtualNetworkAdapter menghapus satu atau beberapa objek adaptor jaringan virtual dari komputer virtual, templat komputer virtual, atau profil perangkat keras yang digunakan di lingkungan Virtual Machine Manager (VMM).

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

Contoh

Contoh 1: Menghapus adaptor jaringan virtual dengan alamat MAC yang ditentukan dari komputer virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.PhysicalAddress -eq "00:16:D3:CC:00:1B" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter

Perintah pertama mendapatkan objek komputer virtual bernama VM01 dan menyimpan objek dalam variabel $VM.

Perintah kedua mendapatkan objek adaptor jaringan virtual pada VM01 yang memiliki alamat MAC yang ditentukan dan menyimpan objek dalam variabel $Adapter.

Perintah terakhir menghapus adaptor jaringan virtual yang disimpan dalam $Adapter dari VM01.

Contoh 2: Menghapus adaptor jaringan virtual yang terhubung ke jaringan virtual tertentu dari komputer virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.VirtualNetwork -eq "ExternalVirtualNetwork01" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter

Perintah pertama mendapatkan objek komputer virtual bernama VM02 dan menyimpan objek dalam variabel $VM.

Perintah kedua mendapatkan objek adaptor jaringan virtual pada VM02 yang terhubung ke jaringan virtual yang ditentukan dan menyimpan objek dalam variabel $Adapter.

Perintah terakhir menghapus objek adaptor jaringan virtual yang disimpan dalam $Adapter dari VM02.

Contoh 3: Menghapus satu-satunya adaptor jaringan virtual dari komputer virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter

Perintah pertama mendapatkan objek komputer virtual bernama VM03 dan menyimpan objek dalam variabel $VM.

Perintah kedua mendapatkan objek adaptor jaringan virtual pada VM03 dan menyimpan objek dalam variabel $Adapter. Contoh ini mengasumsikan bahwa VM03 hanya memiliki satu adaptor jaringan virtual.

Perintah terakhir menghapus objek adaptor jaringan virtual yang disimpan di $Adapter dari VM03.

Contoh 4: Menghapus semua adaptor jaringan virtual dari komputer virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters | Remove-SCVirtualNetworkAdapter

Perintah pertama mendapatkan objek komputer virtual bernama VM04 dan menyimpan objek dalam variabel $VM.

Perintah kedua mendapatkan semua objek adaptor jaringan virtual pada VM04 dan menyimpan objek dalam array objek $Adapters.

Perintah terakhir meneruskan setiap objek yang disimpan dalam $Adapters ke Remove-SCVirtualNetworkAdapter, yang menghapus setiap objek adaptor jaringan virtual dari VM04.

Contoh 5: Hapus adaptor jaringan virtual kedua dari komputer virtual yang memiliki tiga adaptor jaringan virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters[1] | Remove-SCVirtualNetworkAdapter

Perintah pertama mendapatkan objek komputer virtual bernama VM05 dan menyimpan objek dalam variabel $VM.

Perintah kedua mendapatkan semua objek adaptor jaringan virtual pada VM05 dan menyimpan objek dalam array objek $Adapters. Contoh ini mengasumsikan bahwa VM05 memiliki tiga adaptor jaringan virtual.

Perintah terakhir meneruskan objek adaptor jaringan virtual kedua ($Adapters [1]) ke cmdlet Remove-SCVirtualNetworkAdapter , yang menghapus objek adaptor jaringan virtual ini dari VM05.

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

-JobGroup

Menentukan pengidentifikasi untuk serangkaian perintah yang akan berjalan sebagai set tepat sebelum perintah akhir yang menyertakan pengidentifikasi grup pekerjaan yang sama berjalan.

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

-OnBehalfOfUser

Menentukan nama pengguna. Cmdlet ini beroperasi atas nama pengguna yang ditentukan parameter ini.

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

-OnBehalfOfUserRole

Menentukan peran pengguna. Untuk mendapatkan peran pengguna, gunakan cmdlet Get-SCUserRole . Cmdlet ini beroperasi atas nama peran pengguna yang ditentukan parameter ini.

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

-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

-SlotID

Menentukan ID numerik yang digunakan untuk mengidentifikasi perangkat.

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

-VirtualNetworkAdapter

Menentukan objek adaptor jaringan virtual untuk komputer virtual.

Jenis host mendukung jumlah adaptor jaringan virtual berikut:

  • Hyper-V. Hingga empat adaptor yang ditimulasikan per komputer virtual. Tidak ada driver yang tersedia untuk adaptor jaringan yang ditiru pada sistem operasi tamu Windows Server 2003 x64.
  • Hyper-V. Hingga delapan adaptor sintetis per komputer virtual.
  • VMware ESX. Hingga empat adaptor yang ditimulasikan per komputer virtual.
  • Citrix XenServer. Hingga tujuh adaptor yang ditimulasikan per komputer virtual.
Type:VirtualNetworkAdapter
Position:0
Default value:None
Required:True
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

Catatan

  • Memerlukan objek adaptor jaringan virtual VMM, yang dapat diambil dengan menggunakan cmdlet Get-SCVirtualNetworkAdapter .