## PowerCLI Reference

# New-OSCustomizationNicMapping

## Synopsis

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

Syntax

New-OSCustomizationNicMapping -OSCustomizationSpec <OSCustomizationSpec> [-Server <VIServer[]>] [-IpMode <OSCustomizationIPMode>] [-VCApplicationArgument <String>] [[-IpAddress] <String>] [[-SubnetMask] <String>] [[-DefaultGateway] <String>] [-AlternateGateway <String>] [[-Dns] <String[]>] [-Wins <String[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
New-OSCustomizationNicMapping -OSCustomizationSpec <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 -OSCustomizationSpec <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

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

Copyright © VMware, Inc. All rights reserved.