Remove-VMGroupMember

Remove-VMGroupMember

Removes members from a virtual machine group.

Синтаксис

Parameter Set: VM Using ID
Remove-VMGroupMember [-Id] <Guid> [-VM] <VirtualMachine[]> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VM Using InputObject
Remove-VMGroupMember [-VMGroup] <VMGroup> [-VM] <VirtualMachine[]> [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VM Using Name
Remove-VMGroupMember [-Name] <String> [-VM] <VirtualMachine[]> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VMGroup Using ID
Remove-VMGroupMember [-Id] <Guid> [-VMGroupMember] <VMGroup[]> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VMGroup Using InputObject
Remove-VMGroupMember [-VMGroup] <VMGroup> [-VMGroupMember] <VMGroup[]> [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VMGroup Using Name
Remove-VMGroupMember [-Name] <String> [-VMGroupMember] <VMGroup[]> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Подробное описание

The Remove-VMGroupMember cmdlet removes either virtual machines or groups of virtual machines from a virtual machine group.

Параметры

-CimSession<CimSession[]>

Запускает командлет в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные командлета New-CimSession или Get-CimSession. По умолчанию используется текущий сеанс на локальном компьютере.

Псевдонимы	none
Обязательное поле?	false
Позиция?	named
Значение по умолчанию	none
Принимать входные данные конвейера?	false
Обрабатывать символы-шаблоны?	false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts that run this cmdlet. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.

Псевдонимы	none
Обязательное поле?	false
Позиция?	named
Значение по умолчанию	none
Принимать входные данные конвейера?	false
Обрабатывать символы-шаблоны?	false

-Credential<PSCredential[]>

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

Псевдонимы	none
Обязательное поле?	false
Позиция?	named
Значение по умолчанию	none
Принимать входные данные конвейера?	false
Обрабатывать символы-шаблоны?	false

-Id<Guid>

Specifies the unique ID of the virtual machine group from which this cmdlet removes virtual machines or groups of virtual machines.

Псевдонимы	none
Обязательное поле?	true
Позиция?	1
Значение по умолчанию	none
Принимать входные данные конвейера?	false
Обрабатывать символы-шаблоны?	false

-Name<String>

Specifies the name of the virtual machine group from which this cmdlet removes virtual machines or groups of virtual machines.

Псевдонимы	none
Обязательное поле?	true
Позиция?	1
Значение по умолчанию	none
Принимать входные данные конвейера?	false
Обрабатывать символы-шаблоны?	false

-Passthru

Indicates that this cmdlet returns the Microsoft.HyperV.PowerShell.VMGroup object that it configures.

Псевдонимы	none
Обязательное поле?	false
Позиция?	named
Значение по умолчанию	none
Принимать входные данные конвейера?	false
Обрабатывать символы-шаблоны?	false

-VM<VirtualMachine[]>

Specifies an array of virtual machines that this cmdlet removes from a virtual machine group. To obtain a VirtualMachine object, use the Get-VM cmdlet.

Псевдонимы	none
Обязательное поле?	true
Позиция?	2
Значение по умолчанию	none
Принимать входные данные конвейера?	false
Обрабатывать символы-шаблоны?	false

-VMGroup<VMGroup>

Specifies the virtual machine group from which this cmdlet removes virtual machines or groups of virtual machines. To obtain a VMGroup object, use the Get-VMGroup cmdlet.

Псевдонимы	none
Обязательное поле?	true
Позиция?	1
Значение по умолчанию	none
Принимать входные данные конвейера?	false
Обрабатывать символы-шаблоны?	false

-VMGroupMember<VMGroup[]>

Specifies an array of groups of virtual machines that this cmdlet removes from a virtual machine group.

Псевдонимы	none
Обязательное поле?	true
Позиция?	2
Значение по умолчанию	none
Принимать входные данные конвейера?	false
Обрабатывать символы-шаблоны?	false

-Confirm

Выводит приглашение для подтверждения перед выполнением командлета.

Обязательное поле?	false
Позиция?	named
Значение по умолчанию	false
Принимать входные данные конвейера?	false
Обрабатывать символы-шаблоны?	false

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не запущен.

Обязательное поле?	false
Позиция?	named
Значение по умолчанию	false
Принимать входные данные конвейера?	false
Обрабатывать символы-шаблоны?	false

<CommonParameters>

Этот командлет поддерживает общие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Входы

Входной тип — это тип объектов, которые можно направить в командлет.

Выходные данные

Возвращаемый тип — это тип объектов, возвращаемых командлетом.

• Microsoft.HyperV.PowerShell.VMGroup

  This cmdlet returns a VMGroup object, if you specify the Passthru parameter.

Примеры

Example 1: Remove a virtual machine from a group

The first command uses the Get-VM cmdlet to get a virtual machine named ContosoVirtualMachine01. The command stores this virtual machine object in the $VM01 variable.

The second command removes the virtual machine in $VM01 from the group named VirtualMachineGroup.

PS C:\> $VM01 = Get-VM -Name "ContosoVirtualMachine01"
PS C:\> Remove-VMGroupMember -Name "VirtualMachineGroup" -VM $VM01 

См. также

Add-VMGroupMember

Get-VM

Get-VMGroup