Compartilhar via


Set-AzureNetworkSecurityGroupAssociation

Associa um grupo de segurança de rede a uma máquina virtual, função PaaS ou adaptador de rede.

Observação

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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>]

Description

O cmdlet Set-AzureNetworkSecurityGroupAssociation associa um grupo de segurança de rede a uma máquina virtual, função PaaS (plataforma como serviço) ou adaptador de rede.

Exemplos

Exemplo 1: Atribuir uma máquina virtual a um grupo de segurança de rede

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

Esse comando obtém uma máquina virtual chamada ContosoVM06 para o serviço chamado ContosoService e passa esse objeto de máquina virtual para o cmdlet atual. O cmdlet atual atribui o grupo de segurança de rede chamado ContosoNetworkSecurityGroup a essa máquina virtual.

Parâmetros

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome do grupo de segurança de rede que esse cmdlet define.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NetworkInterfaceName

Especifica o nome do adaptador de rede ao qual esse cmdlet aplica o grupo de segurança de rede.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PassThru

Retorna um objeto que representa o item com que você está trabalhando. Por padrão, este cmdlet não gera saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RoleName

Especifica o nome de uma função PaaS à qual esse cmdlet aplica o grupo de segurança de rede.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServiceName

Especifica o nome de um serviço de nuvem. A função PaaS pertence ao serviço especificado por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Slot

Especifica um slot PaaS. A função PaaS para a qual este cmdlet define o grupo de segurança de rede tem o slot especificado por esse parâmetro. Os valores válidos são:

  • Produção
  • Staging

O valor padrão é Production.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubnetName

Especifica o nome de uma sub-rede à qual esse cmdlet associa o grupo de segurança de rede.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VirtualNetworkName

Especifica o nome de uma rede virtual que contém a sub-rede à qual esse cmdlet associa o grupo de segurança de rede.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VM

Especifica a máquina virtual à qual esse cmdlet aplica o grupo de segurança de rede.

Tipo:PersistentVMRoleContext
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

Boolean