Remove-SCVirtualNetworkAdapter
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.