powershellscripts.com

Tutorials  PowerShell Cmdlet Help for New-OSCustomizationNicMapping



NAME
New-OSCustomizationNicMapping

SYNOPSIS
Adds Nic settings mappings to the specified OS customization specifications.

SYNTAX
New-OSCustomizationNicMapping -OSCustomizationSpec [-Server ] [-IpMode mizationIPMode>] [-VCApplicationArgument ] [[-IpAddress] ] [[-SubnetMask] ] [[-DefaultGatew
ay] ] [-AlternateGateway ] [[-Dns] ] [-Wins ] [-WhatIf] [-Confirm] [ meters>]

New-OSCustomizationNicMapping -OSCustomizationSpec [-NetworkAdapterMac ] [-Server
] [-IpMode ] [-VCApplicationArgument ] [[-IpAddress] ] [[-Subne
tMask] ] [[-DefaultGateway] ] [-AlternateGateway ] [[-Dns] ] [-Wins ] [
-WhatIf] [-Confirm] []

New-OSCustomizationNicMapping -OSCustomizationSpec [-Position ] [-Server []>] [-IpMode ] [-VCApplicationArgument ] [[-IpAddress] ] [[-SubnetMask] ring>] [[-DefaultGateway] ] [-AlternateGateway ] [[-Dns] ] [-Wins ] [-WhatIf] [
-Confirm] []


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 va
riable that is passed to the cmdlet is not modified.


PARAMETERS
-OSCustomizationSpec
Specify the OS customization specification to which you want to add the Nic setting mapping.

Required? true
Position? named
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? true

-Server
Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the co
mmand runs on the default servers. For more information about default servers, see the description of Connect-V
IServer.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? true

-IpMode
Specify the IP configuration mode. The valid values are UseDhcp, PromptUser, UseVCApplication, and UseStaticIP.

Required? false
Position? named
Default value UseDhcp
Accept pipeline input? false
Accept wildcard characters? false

-VCApplicationArgument
Specify an optional argument you want to pass to the vCenter Server to obtain an IP address.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-IpAddress
Specify an IP address. Using this parameter automatically sets the IpMode parameter to UseStaticIp.

Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false

-SubnetMask
Specify a subnet mask.

Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false

-DefaultGateway
Specify a default gateway.

Required? false
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false

-AlternateGateway
Specify an alternate gateway.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Dns
Specify a DNS address. This parameter applies only to Windows operating systems.

Required? false
Position? 4
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Wins
Specify WINS servers. This parameter applies only to Windows operating systems.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? true

-WhatIf
Indicate that the cmdlet is run only to display the changes that would be made and actually no objects are modi
fied.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

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

Required? false
Position? named
Default value $true
Accept pipeline input? false
Accept wildcard characters? false

-NetworkAdapterMac
Specify the MAC addresses of the network adapters to which you want to map the new OS customization specificati
ons.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Position
Specify the position of the NIC to which you want to map the OS customization specification.

Required? false
Position? named
Default value last
Accept pipeline input? false
Accept wildcard characters? false


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
OSCustomizationNicMapping[]


NOTES




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

C:\PS>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.






RELATED LINKS
Online version: http://www.vmware.com/support/developer/PowerCLI/PowerCLI501/html/New-OSCustomizationNicMapping.htm
l
Get-OSCustomizationNicMapping
Set-OSCustomizationNicMapping