New-SCPortACLRule

  • Referência
Módulo:
VirtualMachineManager

Cria uma regra de ACL de porta.

Syntax

New-SCPortACLRule
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-PortACL <PortACL>]
   -Type <PortACLRuleDirection>
   -Action <PortACLRuleAction>
   [-LocalAddressPrefix <String>]
   [-LocalPortRange <String>]
   [-RemoteAddressPrefix <String>]
   [-RemotePortRange <String>]
   -Protocol <PortACLRuleProtocol>
   -Priority <UInt16>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet New-SCPortACLRule cria uma regra de ACL (lista de controle de acesso à porta) para o VMM (Virtual Machine Manager).

Exemplos

Exemplo 1: criar uma regra de ACL de porta

PS C:\> $PortACL = New-SCPortACL -Name "RDP ACL" -Description "Acl on RDP access"
PS: C:\> New-SCPortACLRule -Name "AllowRDPAccess" -PortACL $PortACL -Description "Allow RDP Rule from a subnet" -Action Allow -Type Inbound -Priority 110 -Protocol Tcp -LocalPortRange 3389 -RemoteAddressPrefix 10.184.20.0/24

O primeiro comando cria uma ACL de porta e, em seguida, armazena-a na variável $PortACL.

O segundo comando cria uma regra de ACL de porta para permitir o acesso de RDP de uma sub-rede remota.

Parâmetros

-Action

Especifica uma ação de regra de ACL de porta. Os valores aceitáveis para esse parâmetro são:

  • Allow
  • Negar
Type:PortACLRuleAction
Accepted values:Allow, Deny
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifica uma descrição para a regra acl.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalAddressPrefix

Especifica o prefixo de endereço local.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalPortRange

Especifica o intervalo de portas local.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome da regra de ACL de porta.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole . Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PortACL

Especifica um objeto ACL de porta.

Type:PortACL
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Priority

Especifica a prioridade.

Type:UInt16
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

Especifica o protocolo. Os valores aceitáveis para esse parâmetro são:

  • Tcp
  • Udp
  • Qualquer
Type:PortACLRuleProtocol
Accepted values:Tcp, Udp, Any
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RemoteAddressPrefix

Especifica o prefixo de endereço remoto.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemotePortRange

Especifica o intervalo de portas remotas.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Type

Especifica o tipo. Os valores aceitáveis para esse parâmetro são:

  • Entrada
  • Saída
Type:PortACLRuleDirection
Accepted values:Inbound, Outbound
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Especifica um objeto de servidor do VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False