Partilhar via

Set-SCPortACLRule

  • Referência
Módulo:
VirtualMachineManager

Modifica uma regra de ACL de porta.

Sintaxe

Set-SCPortACLRule
   [-VMMServer <ServerConnection>]
   [-PortACLRule] <PortACLRule>
   [-Name <String>]
   [[-Description] <String>]
   [-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 Set-SCPortACLRule modifica uma regra de lista de controle de acesso à porta (ACL) no Virtual Machine Manager (VMM).

Exemplos

Exemplo 1: Modificar a prioridade da regra de ACL de porta

PS C:\> $PortACLRule = Get-SCPortACLRule -Name "AllowRDPAccess"
PS: C:\> Set-SCPortACLRule -PortACLRule $PortACLRule -Priority 220"

O primeiro comando obtém a regra de ACL de porta chamada AllowRDPAccess e, em seguida, armazena-a na variável $PortACLRule.

O segundo comando muda a prioridade da regra em $PortACLRule para 220.

Exemplo 2: Modificar o intervalo de endereços remotos e o protocolo da regra acl da porta

PS C:\> $PortACLRule = Get-SCPortACLRule -Name "AllowRDPAccess"
PS: C:\> Set-SCPortACLRule -PortACLRule $portACLRule -RemoteAddressPrefix 172.185.21.0/24 -Protocol Udp

O primeiro comando obtém a regra de ACL de porta chamada AllowRDPAccess e, em seguida, armazena-a na variável $PortACLRule.

O segundo comando altera o protocolo da regra ACL em $PortACLRule para UDP e define o intervalo de endereços remotos para uma sub-rede diferente.

Parâmetros

-Action

Especifica um objeto de ação de regra de ACL de porta.

Tipo:PortACLRuleAction
Valores aceites:Allow, Deny
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Description

Especifica uma descrição para a regra de ACL de porta.

Tipo:String
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LocalAddressPrefix

Especifica o prefixo do endereço local.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LocalPortRange

Especifica o intervalo de portas locais.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome da regra de ACL de porta.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUser

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUserRole

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

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PortACLRule

Especifica a regra de ACL de porta a ser modificada.

Tipo:PortACLRule
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Priority

Especifica a prioridade.

Tipo:UInt16
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Protocol

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

  • Tcp
  • Udp
  • Qualquer
Tipo:PortACLRuleProtocol
Valores aceites:Tcp, Udp, Any
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RemoteAddressPrefix

Especifica o prefixo de endereço remoto.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RemotePortRange

Especifica o intervalo de portas remotas.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Type

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

  • Entrada
  • Saída
Tipo:PortACLRuleDirection
Valores aceites:Inbound, Outbound
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False