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 (http://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.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-AsJob

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-CimSession<CimSession[]>

エイリアス

Session

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-InputObject<CimInstance[]>

このコマンドレットへの入力を指定します。このパラメーターを使用するか、パイプを使用して入力をこのコマンドレットに渡すことができます。


エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByValue)

ワイルドカード文字を許可する

false

-InterfaceIndex<UInt32[]>

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


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-MACAddress<String[]>

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


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

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


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットによる出力はありません。


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-PrefixLength<Byte[]>

Specifies an array of lengths of IP prefixes.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-ProviderAddress<String[]>

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


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-ThrottleLimit<Int32>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-VlanID<UInt16[]>

Specifies an array of IDs for VLANs for Provider Addresses.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

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

関連トピック

コミュニティの追加

追加
表示: