Remove-SCVirtualNetworkAdapter

Başvuru

Modül:: VirtualMachineManager

VMM'den bir sanal ağ bağdaştırıcısı nesnesini kaldırır.

Syntax

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

Description

Remove-SCVirtualNetworkAdapter cmdlet'i bir sanal makineden, sanal makine şablonundan veya bir Virtual Machine Manager (VMM) ortamında kullanılan donanım profilinden bir veya daha fazla sanal ağ bağdaştırıcısı nesnesini kaldırır.

Bu cmdlet, başarılı olduğunda nesnesini döndürür (MarkedForDeletion özelliği $True olarak ayarlanır) veya hata durumunda bir hata iletisi döndürür.

Örnekler

Örnek 1: Belirtilen MAC adresine sahip bir sanal ağ bağdaştırıcısını bir sanal makineden kaldırma

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

İlk komut VM01 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut, VM01'de belirtilen MAC adresine sahip sanal ağ bağdaştırıcısı nesnesini alır ve nesneyi $Adapter değişkeninde depolar.

Son komut, $Adapter'de depolanan sanal ağ bağdaştırıcısını VM01'den kaldırır.

Örnek 2: Belirli bir sanal ağa bağlı bir sanal ağ bağdaştırıcısını bir sanal makineden kaldırma

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

İlk komut VM02 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut, belirtilen sanal ağa bağlı vm02 üzerindeki sanal ağ bağdaştırıcısı nesnesini alır ve nesneyi $Adapter değişkeninde depolar.

Son komut, VM02’den $Adapter değişkeninde depolanan sanal ağ bağdaştırıcısı nesnesini kaldırır.

Örnek 3: Bir sanal makineden tek sanal ağ bağdaştırıcısını kaldırma

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

İlk komut VM03 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut VM03'teki sanal ağ bağdaştırıcısı nesnesini alır ve nesneyi $Adapter değişkeninde depolar. Bu örnekte, VM03'de yalnızca bir sanal ağ bağdaştırıcısı olduğu varsayılır.

Son komut, vm03'ten $Adapter depolanan sanal ağ bağdaştırıcısı nesnesini kaldırır.

Örnek 4: Bir sanal makineden tüm sanal ağ bağdaştırıcılarını kaldırma

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

İlk komut VM04 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut, VM04 üzerindeki tüm sanal ağ bağdaştırıcısı nesnelerini alır ve nesneleri $Adapters nesne dizisinde depolar.

Son komut, $Adapters'de depolanan her nesneyi Remove-SCVirtualNetworkAdapter'a geçirir ve bu da her sanal ağ bağdaştırıcısı nesnesini VM04'ten kaldırır.

Örnek 5: Üç sanal ağ bağdaştırıcısı olan bir sanal makineden ikinci sanal ağ bağdaştırıcısını kaldırma

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

İlk komut VM05 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut, VM05'teki tüm sanal ağ bağdaştırıcısı nesnelerini alır ve nesneleri $Adapters nesne dizisinde depolar. Bu örnekte, VM05'in üç sanal ağ bağdaştırıcısı olduğu varsayılır.

Son komut, ikinci sanal ağ bağdaştırıcısı nesnesini ($Adapters [1]) Remove-SCVirtualNetworkAdapter cmdlet'ine geçirir ve bu da bu sanal ağ bağdaştırıcısı nesnesini VM05'ten kaldırır.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-JobGroup

Aynı iş grubu tanımlayıcısını içeren son komut çalıştırmadan hemen önce küme olarak çalışacak bir dizi komut için tanımlayıcı belirtir.

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

-JobVariable

İş ilerleme durumunun izlendiğini ve bu parametre tarafından adlandırılan değişkende depolandığını belirtir.

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

-OnBehalfOfUser

Bir kullanıcı adı belirtir. Bu cmdlet, bu parametrenin belirttiği kullanıcı adına çalışır.

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

-OnBehalfOfUserRole

Kullanıcı rolünü belirtir. Kullanıcı rolü almak için Get-SCUserRole cmdlet'ini kullanın. Bu cmdlet, bu parametrenin belirttiği kullanıcı rolü adına çalışır.

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

-PROTipID

Bu eylemi tetikleyen Performans ve Kaynak İyileştirme ipucunun (PRO ipucu) kimliğini belirtir. Bu parametre PRO ipuçlarını denetlemenize olanak tanır.

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

-RunAsynchronously

Denetimin komut kabuğuna hemen döndürülmesi için işin zaman uyumsuz olarak çalıştığını gösterir.

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

-SlotID

Bir cihazı tanımlamak için kullanılan sayısal kimliği belirtir.

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

-VirtualNetworkAdapter

Bir sanal makine için bir sanal ağ bağdaştırıcısı nesnesi belirtir.

Konak türleri aşağıdaki sayıda sanal ağ bağdaştırıcısını destekler:

Hyper-V. Sanal makine başına en fazla dört öykünülmüş bağdaştırıcı. Windows Server 2003 x64 konuk işletim sistemindeki öykünülmüş ağ bağdaştırıcısı için kullanılabilir sürücü yoktur.
Hyper-V. Sanal makine başına sekiz adede kadar sentetik bağdaştırıcı.
VMware ESX. Sanal makine başına en fazla dört öykünülmüş bağdaştırıcı.
Citrix XenServer. Sanal makine başına en fazla yedi öykünülmüş bağdaştırıcı.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Notlar

Get-SCVirtualNetworkAdapter cmdlet'i kullanılarak alınabilen bir VMM sanal ağ bağdaştırıcısı nesnesi gerektirir.