Add-AzVMNetworkInterfaceConfiguration
仮想マシンに暗黙的なネットワーク インターフェイス構成を追加します。
構文
Default (既定)
Add-AzVMNetworkInterfaceConfiguration
[-VM] <PSVirtualMachine>
[-Name <String>]
[-Primary]
[-IpConfiguration <VirtualMachineNetworkInterfaceIPConfiguration[]>]
[-NetworkApiVersion <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Add-AzVMNetworkInterfaceConfiguration コマンドレットは、構成可能な仮想マシン (VM) オブジェクトに暗黙的なネットワーク インターフェイス構成を追加します。
必要に応じネットワーク プロファイルを初期化し、既存のネットワーク インターフェイス構成を保持します。
例
例 1: ファースト パーティのサービス IP タグを使用して暗黙的なネットワーク インターフェイスを追加する
$serviceTagResourceId = '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/firstPartyServiceTags/myServiceTag'
$subnetId = '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet'
$ipTag = New-AzVMIpTagConfig -IpTagType 'FirstPartyUsage' -FirstPartyServiceTagId $serviceTagResourceId
$ipConfig = New-AzVMIpConfig -Name 'ipConfig' -SubnetId $subnetId -PublicIPAddressConfigurationName 'publicIpConfig' -IpTag $ipTag
$vmConfig = New-AzVMConfig -VMName 'myVM' -VMSize 'Standard_D2s_v5'
$vmConfig = Add-AzVMNetworkInterfaceConfiguration -VM $vmConfig -Name 'nicConfig' -Primary -IpConfiguration $ipConfig -NetworkApiVersion '2022-11-01'
この例では、暗黙的なネットワーク インターフェイスと入れ子になったパブリック IP 構成を VM 構成オブジェクトに追加します。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DefaultProfile
Azureとの通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| エイリアス: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IpConfiguration
ネットワーク インターフェイス構成に追加する IP 構成を指定します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Name
ネットワーク インターフェイス構成名を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-NetworkApiVersion
Microsoftを指定します。暗黙的なネットワーク リソースの作成に使用されるネットワーク API バージョン。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Primary
これがプライマリ ネットワーク インターフェイス構成であるかどうかを指定します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VM
更新する構成可能な VM オブジェクトを指定します。
New-AzVMConfig を使用してオブジェクトを作成します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。
出力
