Remove-SCVirtualMachine
VMM'den bir sanal makine nesnesi kaldırır.
Syntax
Remove-SCVirtualMachine
[-VM] <VM>
[-SkipFileRemoval]
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Description
Remove-SCVirtualMachine cmdlet'i bir konakta dağıtılan veya Virtual Machine Manager (VMM) kitaplık sunucusunda depolanan bir sanal makine nesnesini kaldırır.
Bu cmdlet, sanal makine kaydını VMM veritabanından siler, sanal makineyle ilişkili tüm dosyaları siler ve sanal makineyi dağıtıldığı konaktan veya depolandığı kitaplık sunucusundan kaldırır.
Bu sanal makine için Hyper-V veya VMware yerine konakta bir klasör oluşturulduysa ve bu klasör başka sanal makine veya başka veri içermiyorsa, sanal makineyi kaldırdıktan sonra klasörü silmek için dosya sistemini kullanabilirsiniz.
Force parametresini belirtirseniz, bu cmdlet yalnızca VMM veritabanından sanal makineyi siler. Sanal makinenin kendisini silmez.
Bu cmdlet, MarkedForDeletion özelliği için $True değerine sahip olan başarılı olduğunda nesnesini döndürür. Başarısız olursa, cmdlet bir hata iletisi döndürür.
Örnekler
Örnek 1: Konakta dağıtılan belirli bir sanal makineyi kaldırma
PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.VMHost.Name -eq "VMHost01.Contoso.com" -and $_.Name -eq "VM01" }
PS C:\> Remove-SCVirtualMachine -VM $VM
İlk komut, VMHost01 üzerinde dağıtılan VM01 adlı sanal makine nesnesini alır ve ardından sanal makine nesnesini $VM değişkeninde depolar.
İkinci komut, $VM'de depolanan nesneyi kaldırır ve karşılık gelen sanal makine dosyalarını kendi konağındaki dosya sisteminden siler.
Örnek 2: Belirli bir dize içeren adlara sahip tüm sanal makineleri kaldırma
PS C:\> $VMs = @(Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -Match "VM0" } )
PS C:\> $VMs | Remove-SCVirtualMachine
İlk komut, adı VM0 dizesini içeren herhangi bir konakta dağıtılan tüm sanal makine nesnelerini alır ve ardından bu sanal makine nesnelerini $VMs adlı dizide depolar.
İkinci komut, $VMs dizisindeki her sanal makine nesnesini kaldırır ve ilgili sanal makine dosyalarını her konaktaki dosya sisteminden siler.
Örnek 3: VMM kitaplık sunucusunda depolanan belirli bir sanal makineyi kaldırma
PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer1.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "VM02" }
PS C:\> Remove-SCVirtualMachine -VM $VM
İlk komut, VM03 adlı sanal makineyi temsil eden nesneyi alır ve ardından sanal makine nesnesini $VM içinde depolar. Bu örnekte, VM03 adlı yalnızca bir sanal makine vardır.
İkinci komut, VM03'i temsil eden nesneyi kitaplıktan kaldırır ve ilgili sanal makine dosyalarını kitaplık sunucusundaki dosya sisteminden siler.
Örnek 4: VMM kitaplığından depolanan birden çok sanal makineyi kaldırma
PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "VM0" }
PS C:\> $VMs | Remove-SCVirtualMachine -Confirm
İlk komut, adları VM0 dizesini içeren ve LibraryServer01'de depolanan tüm sanal makine nesnelerini alır. Komut daha sonra sanal makine nesnelerini $VMs adlı dizide depolar.
İkinci komut, $VMs'de depolanan her sanal makine nesnesini geçerli cmdlet'e geçirir; bu da her nesneyi kitaplıktan kaldırır ve ilgili sanal makine dosyalarını kitaplık sunucusundaki dosya sisteminden siler. Confirm parametresi, bu sanal makinelerin her birini silmek isteyip istemediğinizi onaylamanızı ister.
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 |
-Force
Bu cmdlet'in sanal makineyi yalnızca VMM veritabanından sildiğini gösterir. Sanal makinenin kendisini silmez.
Not
Hizmet şablonları veya VMRole kullanılarak dağıtılan sanal makine için bu parametre yoksayılır ve gerçek sanal makine de silinir.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
İş ilerleme durumunun izlendiği ve depolandığı bir değişken 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 |
-SkipFileRemoval
Bu cmdlet'in sanal makineyle ilgili dosyaları doğrudan kaldırmadığını gösterir. Bu parametreyi belirtirseniz, herhangi bir dosyayı doğrudan silme girişiminde bulunulmaz.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
Bir sanal makine nesnesi belirtir.
Type: | VM |
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
Bu cmdlet, Get-SCVirtualMachine cmdlet'i kullanılarak alınabilen bir VMM sanal makine nesnesi gerektirir.