你当前正在访问 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 的 Azure 资源管理器 (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 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 |