Set-NetVirtualizationProviderAddress

Set-NetVirtualizationProviderAddress

Changes a VLAN ID or prefix length for a Provider Address.

구문

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

Parameter Set: InputObject (cdxml)
Set-NetVirtualizationProviderAddress -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-MACAddress <String> ] [-PassThru] [-PrefixLength <Byte> ] [-ThrottleLimit <Int32> ] [-VlanID <UInt16> ] [ <CommonParameters>]

자세한 설명

The Set-NetVirtualizationProviderAddress cmdlet changes a virtual local area network (VLAN) ID or prefix length for Provider Addresses used with Network Virtualization. For more information, see Network Virtualization technical details (https://technet.microsoft.com/library/jj134174.aspx) on TechNet.

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

매개 변수

-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[]>

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

별칭

없음

필수 여부

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 a media access control (MAC) address that corresponds to the Provider Address.

별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-PassThru

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

별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-PrefixLength<Byte>

Specifies the length of an IP prefix.

별칭

없음

필수 여부

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>

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

별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-VlanID<UInt16>

Specifies an ID for a VLAN for the Provider Address.

별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

<CommonParameters>

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

입력

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

출력

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

예제

Example 1: Change a virtual LAN ID

This command changes the virtual LAN ID for the Provider Address 192.168.2.3 on the the interface that has the Index 17.

PS C:\> Set-NetVirtualizationProviderAddress -ProviderAddress "192.168.2.3" -InterfaceIndex 17 -VlanID 201

Example 2: Change a virtual LAN ID for specified Provider Addresses

This command uses the Get-NetVirtualizationProviderAddress cmdlet to get all the Provider Addresses for the interface that has the index 23, and then passes them to the Set-NetVirtualizationProviderAddress cmdlet by using the pipe operator. The command assigns a value of 20 for the virtual LAN ID of all the Provider Address for the interface.

PS C:\> Get-NetVirtualizationProviderAddress -InterfaceIndex 23 | Set-NetVirtualizationProviderAddress -VlanID 20

관련 항목

Get-NetVirtualizationProviderAddress

New-NetVirtualizationProviderAddress

Remove-NetVirtualizationProviderAddress