Set-AzureNetworkSecurityGroupAssociation

ネットワーク セキュリティ グループを仮想マシン、PaaS ロール、またはネットワーク アダプターに関連付けます。

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される PowerShell モジュールです。

構文

Set-AzureNetworkSecurityGroupAssociation
   -Name <String>
   [-Force]
   [-PassThru]
   -VirtualNetworkName <String>
   -SubnetName <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureNetworkSecurityGroupAssociation
   -Name <String>
   [-Force]
   [-PassThru]
   -VM <PersistentVMRoleContext>
   -ServiceName <String>
   [-NetworkInterfaceName <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureNetworkSecurityGroupAssociation
   -Name <String>
   [-Force]
   [-PassThru]
   [-Slot <String>]
   -RoleName <String>
   -ServiceName <String>
   [-NetworkInterfaceName <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

説明

Set-AzureNetworkSecurityGroupAssociation コマンドレットは、ネットワーク セキュリティ グループを仮想マシン、サービスとしてのプラットフォーム (PaaS) ロール、またはネットワーク アダプターに関連付けます。

例 1: 仮想マシンをネットワーク セキュリティ グループに割り当てる

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "ContosoVM06" | Set-AzureNetworkSecurityGroupAssociation -Name "ContosoNetworkSecurityGroup"

このコマンドは、ContosoService という名前のサービスの ContosoVM06 という名前の仮想マシンを取得し、その仮想マシン オブジェクトを現在のコマンドレットに渡します。 現在のコマンドレットは、ContosoNetworkSecurityGroup という名前のネットワーク セキュリティ グループをその仮想マシンに割り当てます。

パラメーター

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

このコマンドレットが設定するネットワーク セキュリティ グループの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-NetworkInterfaceName

このコマンドレットがネットワーク セキュリティ グループを適用するネットワーク アダプターの名前を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PassThru

作業中の項目を表すオブジェクトを返します。 既定では、このコマンドレットによる出力はありません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RoleName

このコマンドレットがネットワーク セキュリティ グループを適用する PaaS ロールの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ServiceName

クラウド サービスの名前を指定します。 PaaS ロールは、このパラメーターが指定するサービスに属します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Slot

PaaS スロットを指定します。 このコマンドレットがネットワーク セキュリティ グループを設定する PaaS ロールには、このパラメーターが指定するスロットがあります。 有効な値は次の通りです。

  • Production
  • ステージング

既定値は Production です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SubnetName

このコマンドレットがネットワーク セキュリティ グループを関連付けるサブネットの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VirtualNetworkName

このコマンドレットがネットワーク セキュリティ グループを関連付けるサブネットを含む仮想ネットワークの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VM

このコマンドレットがネットワーク セキュリティ グループを適用する仮想マシンを指定します。

型:PersistentVMRoleContext
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

出力

Boolean