Remove-NetVirtualizationProviderAddress

Remove-NetVirtualizationProviderAddress

Deletes Provider Addresses.

구문

Parameter Set: ByName
Remove-NetVirtualizationProviderAddress [-AddressState <AddressState[]> ] [-AsJob] [-CimSession <CimSession[]> ] [-InterfaceIndex <UInt32[]> ] [-MACAddress <String[]> ] [-ManagedByCluster <Boolean[]> ] [-PassThru] [-PrefixLength <Byte[]> ] [-ProviderAddress <String[]> ] [-ThrottleLimit <Int32> ] [-VlanID <UInt16[]> ] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Remove-NetVirtualizationProviderAddress -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

자세한 설명

The Remove-NetVirtualizationProviderAddress cmdlet deletes Provider Addresses configured in Network Virtualization. A Provider Address is an IPv4 or IPv6 address that Network Virtualization uses for multiple virtual Customer Addresses. For more information, see Network Virtualization technical details (https://technet.microsoft.com/library/jj134174.aspx) on TechNet.

You can specify which Provider Addresses to delete by using address state, interface index, prefix length, IP address, or VLAN ID, or you can use the Get-NetVirtualizationProviderAddress cmdlet to get Provider Addresses to delete.

You can use this cmdlet to remove a Provider Address when no virtual machines (VMs) use that address. If you deleted or migrated all the VMs from a host, you could then remove the Provider Address.

매개 변수

-AddressState<AddressState[]>

Specifies an array of states of Provider Addresses. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- Preferred. The address is unique.
-- Tentative. The address is not yet verified.
-- Duplicate. There is a duplicate address on the network.
-- Invalid. The address lifetime has expired.
-- Deprecated. The address cannot start new connections.

-AsJob

-CimSession<CimSession[]>

-InputObject<CimInstance[]>

이 cmdlet에 대한 입력을 지정합니다. 이 매개 변수를 사용하거나 입력을 이 cmdlet으로 파이프할 수 있습니다.

-InterfaceIndex<UInt32[]>

Specifies an array of indexes for network interfaces that have Network Virtualization enabled.

-MACAddress<String[]>

Specifies an array of media access control (MAC) addresses that corresponds to the Provider Address.

-ManagedByCluster<Boolean[]>

Specifies an array of Boolean values that determines if a highly available Provider Address (PA) configuration entry exists on a Hyper-V Network Virtualization gateway. If you use a PA cluster resource, this value displays as $True; otherwise, the value displays as $False. This parameter is a read-only parameter, used by an administrator to diagnose problems.

-PassThru

작업하고 있는 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

-PrefixLength<Byte[]>

Specifies an array of lengths of IP prefixes.

-ProviderAddress<String[]>

Specifies an array of IP addresses. You can use IPv4 or IPv6 addresses.

-ThrottleLimit<Int32>

이 cmdlet을 실행하도록 설정할 수 있는 최대 동시 작업 수를 지정합니다. 이 매개 변수가 생략되거나 값 0이 입력되면 Windows PowerShell®은 컴퓨터에서 실행 중인 CIM cmdlet의 수에 따라 cmdlet에 대한 최적의 제한 한도를 계산합니다. 제한 한도는 현재 cmdlet에만 적용되며 세션이나 컴퓨터에는 적용되지 않습니다.

-VlanID<UInt16[]>

Specifies an array of IDs for VLANs for Provider Addresses.

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

예제

Example 1: Remove a Provider Address

This command deletes the Provider Address 2001:DB8:11:22:33:44:55:6 on the current host.

PS C:\> Remove-NetVirtualizationProviderAddress -ProviderAddress "2001:DB8:11:22:33:44:55:6"

Example 2: Remove Provider Addresses for an interface

This command removes all the Provider Addresses on the interface that has an index of 13.

PS C:\> Remove-NetVirtualizationProviderAddress -InterfaceIndex 13

관련 항목

Get-NetVirtualizationProviderAddress

New-NetVirtualizationProviderAddress

Set-NetVirtualizationProviderAddress