New-AzureNetworkInterface
New-AzureNetworkInterface
Creates a network interface.
Syntax
Parameter Set: SetByResource
New-AzureNetworkInterface -Location <String> -Name <String> -ResourceGroupName <String> -Subnet <PSSubnet> [-DnsServer <System.Collections.Generic.List`1[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]> ] [-Force] [-IpConfigurationName <String> ] [-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=0.8.16.1, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]> ] [-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=0.8.16.1, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]> ] [-NetworkSecurityGroup <PSNetworkSecurityGroup> ] [-PrivateIpAddress <String> ] [-Profile <AzureProfile> ] [-PublicIpAddress <PSPublicIpAddress> ] [-Tag <Hashtable[]> ] [ <CommonParameters>]
Parameter Set: SetByResourceId
New-AzureNetworkInterface -Location <String> -Name <String> -ResourceGroupName <String> -SubnetId <String> [-DnsServer <System.Collections.Generic.List`1[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]> ] [-Force] [-IpConfigurationName <String> ] [-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]> ] [-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]> ] [-NetworkSecurityGroupId <String> ] [-PrivateIpAddress <String> ] [-Profile <AzureProfile> ] [-PublicIpAddressId <String> ] [-Tag <Hashtable[]> ] [ <CommonParameters>]
Detailed Description
The New-AzureNetworkInterface cmdlet creates an Azure network interface.
Parameters
-DnsServer<System.Collections.Generic.List`1[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]>
Specifies the DNS server for the network interface.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-Force
Forces the creation of the network interface even if a network interface with the same name already exists.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-IpConfigurationName<String>
Specifies the name of an IP configuration.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-LoadBalancerBackendAddressPool<System.Collections.Generic.List`1[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=0.8.16.1, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]>
Specifies a BackendAddressPool object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-LoadBalancerBackendAddressPoolId<System.Collections.Generic.List`1[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]>
Specifies the ID of a BackendAddressPool object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-LoadBalancerInboundNatRule<System.Collections.Generic.List`1[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=0.8.16.1, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]>
Specifies an inbound NAT rule configuration for a load balancer.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-LoadBalancerInboundNatRuleId<System.Collections.Generic.List`1[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]>
Specifies the ID of an inbound NAT rule configuration for a load balancer.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-Location<String>
Specifies the region for a network interface.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies the name of the network interface to create.
Aliases |
ResourceName |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-NetworkSecurityGroup<PSNetworkSecurityGroup>
Specifies a NetworkSecurityGroup object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-NetworkSecurityGroupId<String>
Specifies the ID of a network security group.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-PrivateIpAddress<String>
Specifies a static IPv4 IP address to assign to this network interface. This parameter is optional.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-Profile<AzureProfile>
Specifies an Azure profile.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PublicIpAddress<PSPublicIpAddress>
Specifies a PublicIPAddress object to assign to a network interface.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-PublicIpAddressId<String>
Specifies the ID of a PublicIPAddress object to assign to a network interface.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-ResourceGroupName<String>
Specifies the name of a resource group. This cmdlet creates a network interface for the resource group that this parameter specifies.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-Subnet<PSSubnet>
Specifies a Subnet object. This cmdlet creates a network interface for the subnet that this parameter specifies.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-SubnetId<String>
Specifies the ID of the subnet for which to create a network interface.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-Tag<Hashtable[]>
Specifies a dictionary of tags to associate with a network interface.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.