PowerCLI Reference

New-OSCustomizationNicMapping

Synopsis

This cmdlet adds NIC settings mappings to the specified OS customization specifications.

Syntax

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

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

Related Commands

Online Version
Get-OSCustomizationNicMapping
Set-OSCustomizationNicMapping

Detailed Description

This cmdlet 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	Type	Description	Required?	Pipeline Input
IpAddress	String	Specifies an IP address. Using this parameter automatically sets the IpMode parameter to UseStaticIp.	false	False
SubnetMask	String	Specifies a subnet mask.	false	False
DefaultGateway	String	Specifies a default gateway.	false	False
Dns	String[]	Specifies a DNS address. This parameter applies only to Windows operating systems.	false	False
AlternateGateway	String	Specifies an alternate gateway.	false	False
Confirm	SwitchParameter	If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.	false	False
IpMode	OSCustomizationIPMode	Specifies the IP configuration mode. The valid values are UseDhcp, PromptUser, UseVCApplication, and UseStaticIP.	false	False
NetworkAdapterMac	String[]	Specifies the MAC addresses of the network adapters to which you want to map the new OS customization specifications.	false	False
OSCustomizationSpec	OSCustomizationSpec	Specifies the OS customization specification to which you want to add the NIC setting mapping. Passing multiple values to this parameter is obsolete.	true	True (ByValue)
Position	Int32[]	Specifies the position of the NIC to which you want to map the OS customization specification.	false	False
Server	VIServer[]	Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.	false	False
VCApplicationArgument	String	Specifies an optional argument you want to pass to the vCenter Server to obtain an IP address.	false	False
WhatIf	SwitchParameter	Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.	false	False
Wins	String[]	Specifies WINS servers. This parameter applies only to Windows operating systems.	false	False

Return Type

The one or more newly created OSCustomizationNicMapping objects

Notes

Examples

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

New-OSCustomizationNicMapping -OSCustomizationSpec $spec -IpMode UseStaticIP -IPAddress 10.0.0.1 -SubnetMask 255.255.255.0 -DefaultGateway 10.0.0.253 -DnsServer 10.0.0.253

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