你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzureNetworkSecurityGroupAssociation
将网络安全组关联到虚拟机、PaaS 角色或网络适配器。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager （ASM） API 的旧 Azure 资源。 创建新的资源时，不建议使用此旧版 PowerShell 模块，因为 ASM 计划停用。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器 （ARM） 资源。
语法
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 cmdlet 将网络安全组关联到虚拟机、平台即服务（PaaS）角色或网络适配器。
示例
示例 1：将虚拟机分配到网络安全组
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "ContosoVM06" | Set-AzureNetworkSecurityGroupAssociation -Name "ContosoNetworkSecurityGroup"此命令获取名为 ContosoService 的服务的名为 ContosoVM06 的虚拟机，并将该虚拟机对象传递给当前 cmdlet。 当前 cmdlet 将名为 ContosoNetworkSecurityGroup 的网络安全组分配给该虚拟机。
参数
-Force
强制运行命令而不要求用户确认。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定此 cmdlet 设置的网络安全组的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-NetworkInterfaceName
指定此 cmdlet 应用网络安全组的网络适配器的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-PassThru
返回一个代表你所处理的项目的对象。 默认情况下，此 cmdlet 将不产生任何输出。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
| 类型: | AzureSMProfile |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RoleName
指定此 cmdlet 向其应用网络安全组的 PaaS 角色的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ServiceName
指定云服务的名称。 PaaS 角色属于此参数指定的服务。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Slot
指定 PaaS 槽。 此 cmdlet 为其设置网络安全组的 PaaS 角色具有此参数指定的槽。 有效值为：
- 生产
- 过渡
默认值为“生产”。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SubnetName
指定此 cmdlet 将网络安全组关联到的子网的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-VirtualNetworkName
指定包含此 cmdlet 关联网络安全组的子网的虚拟网络的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-VM
指定此 cmdlet 将网络安全组应用到的虚拟机。
| 类型: | PersistentVMRoleContext |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |