New-OSCustomizationNicMapping

Synopsis

Adds Nic settings mappings to the specified OS customization specifications.

Syntax

New-OSCustomizationNicMapping -Spec <OSCustomizationSpec[]> [-Server <VIServer[]>] [-IpMode <OSCustomizationIPMode>] [-VCApplicationArgument <String>] [[-IpAddress] <String>] [[-SubnetMask] <String>] [[-DefaultGateway] <String>] [-AlternateGateway <String>] [[-Dns] <String[]>] [-Wins <String[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
New-OSCustomizationNicMapping -Spec <OSCustomizationSpec[]> [-NetworkAdapterMac <String[]>] [-Server <VIServer[]>] [-IpMode <OSCustomizationIPMode>] [-VCApplicationArgument <String>] [[-IpAddress] <String>] [[-SubnetMask] <String>] [[-DefaultGateway] <String>] [-AlternateGateway <String>] [[-Dns] <String[]>] [-Wins <String[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
New-OSCustomizationNicMapping -Spec <OSCustomizationSpec[]> [-Position <Int32[]>] [-Server <VIServer[]>] [-IpMode <OSCustomizationIPMode>] [-VCApplicationArgument <String>] [[-IpAddress] <String>] [[-SubnetMask] <String>] [[-DefaultGateway] <String>] [-AlternateGateway <String>] [[-Dns] <String[]>] [-Wins <String[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Get-OSCustomizationNicMapping
Set-OSCustomizationNicMapping

Detailed Description

Adds Nic settings mappings to the specified OS customization specifications. If the given specification is server-side, it is updated on the server. If it is client-side, the reference that is kept in-memory is updated but the variable that is passed to the cmdlet is not modified.

Parameters

Name	Description	Required?	Pipeline Input	Default Value
Spec	Specify the OS customization specification to which you want to add the Nic setting mapping.	true	true (ByValue)
Server	Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.	false	false
IpMode	Specify the IP configuration mode. The valid values are UseDhcp, PromptUser, UseVCApplication, and UseStaticIP.	false	false	UseDhcp
VCApplicationArgument	Specify an optional argument you want to pass to the vCenter Server to obtain an IP address.	false	false
IpAddress	Specify an IP address. Using this parameter automatically sets the IpMode parameter to UseStaticIp.	false	false
SubnetMask	Specify a subnet mask.	false	false
DefaultGateway	Specify a default gateway.	false	false
AlternateGateway	Specify an alternate gateway.	false	false
Dns	Specify a DNS address.	false	false
Wins	Specify WINS servers.	false	false
WhatIf	Indicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.	false	false
Confirm	Indicate that the cmdlet asks for confirmation before running.	false	false
NetworkAdapterMac	Specify the MAC addresses of the network adapters to which you want to map the new OS customization specifications.	false	false
Position	Specify the position of the NIC to which you want to map the OS customization specification.	false	false	last

Input Type

Return Type

VMware.VimAutomation.Types.OSCustomizationNicMapping

Notes

Examples

--------------  Example 1 --------------

C:\PS>New-OSCustomizationNicMapping -Spec $spec -IpMode UseStaticIP -IPAddress 1
0.0.0.1 -SubnetMask 255.255.255.0 -DefaultGateway 10.0.0.253 -DnsServer 10.0.0.2
53


Creates a new NIC mapping for the OS customization spec stord in $spec.