你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzStackHCIVMNetworkInterface

用于创建或更新网络接口的操作。 请注意,某些属性只能在网络接口创建期间设置。

语法

New-AzStackHCIVMNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   [-DnsServer <String[]>]
   [-IpAddress <String>]
   [-MacAddress <String>]
   [-SubnetId <String>]
   [-SubnetName <String>]
   [-SubnetResourceGroup <String>]
   [-IpConfiguration <Hashtable[]>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

用于创建或更新网络接口的操作。 请注意,某些属性只能在网络接口创建期间设置。

示例

示例 1:创建网络接口

New-AzStackHCIVMNetworkInterface  -Name "testNic" -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}" -Location "eastus" -SubnetName "testLnet"

Name            ResourceGroupName
----            -----------------
testNic      test-rg

此命令在指定的资源组中创建网络接口。

参数

-AsJob

以作业身份运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CustomLocationId

扩展位置的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:PSObject
别名:AzureRMContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DnsServer

接口的 DNS 服务器 IP 地址列表

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-IpAddress

PrivateIPAddress - IP 配置的专用 IP 地址。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-IpConfiguration

网络接口的 IPConfiguration 列表。

类型:Hashtable[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Location

资源所在的地理位置

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-MacAddress

MacAddress - 网络接口的 MAC 地址。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

网络接口的名称

类型:String
别名:NetworkInterfaceName
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-NoWait

异步运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceGroupName

资源组的名称。 此名称不区分大小写。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-SubnetId

子网的 ARM 资源 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SubnetName

子网的名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SubnetResourceGroup

子网的资源组。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SubscriptionId

目标订阅的 ID。

类型:String
Position:Named
默认值:(Get-AzContext).Subscription.Id
必需:False
接受管道输入:False
接受通配符:False

-Tag

资源标记。

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输出

INetworkInterfaces