MSFT_NetFirewallHyperVRule classe

Artigo
05/18/2024

Representa uma regra Hyper-V do firewall do Windows Defender.

Para obter mais informações, consulte a documentação do Powershell New-NetFirewallHyperVRule.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas.

Sintaxe

class MSFT_NetFirewallHyperVRule : CIM_PolicyRule
{
  string DisplayName;
  uint16 RulePriority;
  uint16 Direction;
  string VMCreatorId;
  string Protocol;
  string LocalAddresses[];
  string LocalPorts[];
  string RemoteAddresses[];
  string RemotePorts[];
  uint16 Action;
  uint16 EnforcementStatus;
  uint16 PolicyStoreSourceType;
  string PortStatuses[];
  uint16 Profiles;
  uint32 Enable();
  uint32 Disable();
  uint32 Rename
  (
    string NewName
  );
  uint32 EnumerateFull
  (
    string Dependents[]
  );
  string SystemCreationClassName;
  string SystemName;
  string CreationClassName;
  string PolicyRuleName;
  uint16 ConditionListType;
  string RuleUsage;
  uint16 Priority;
  boolean Mandatory;
  uint16 SequencedActions;
  uint16 ExecutionStrategy;
  uint16 PolicyDecisionStrategy;
  string PolicyRoles[];
  uint16 Enabled = 1;
  string CommonName;
  string PolicyKeywords[];
  string InstanceID;
  string Caption;
  string Description;
  string ElementName;
};

Membros

A classe MSFT_NetFirewallHyperVRule tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe MSFT_NetFirewallHyperVRule tem esses métodos.

Método	Descrição
Desabilitar	Desative essa regra.
Habilitar	Habilite essa regra.
EnumerarCompleto	Enumera todos os campos de todas as regras.
Renomear	Renomeie essa regra.

Propriedades

A classe MSFT_NetFirewallHyperVRule tem essas propriedades.

DisplayName

Tipo de dados: string

Tipo de acesso: Somente leitura

O nome localizado desta regra. O valor deste campo é baseado no valor de ElementName. As alterações nesse campo são ignoradas.

RulePriority

Tipo de dados: uint16

Tipo de acesso: leitura/gravação

Determina a ordem em que as regras são avaliadas. As regras de prioridade mais baixa são avaliadas primeiro. Se esse valor for 0 (unset), o sistema atribuirá um valor de 1 às regras com a ação Block e 2 às regras com a ação Allow.

Direction

Tipo de dados: uint16

Tipo de acesso: leitura/gravação

Especifica qual direção do tráfego deve corresponder a essa regra.

Entrada (1)

Saída (2)

VMCreatorId

Tipo de dados: string

Tipo de acesso: leitura/gravação

Especifica o identificador exclusivo do criador da VM ao qual esta regra é aplicável. Um valor GUID nulo significa que essa regra é aplicável a todas as portas Hyper-V no sistema.

Protocol

Tipo de dados: string

Tipo de acesso: leitura/gravação

Número de protocolo de Internet IANA ao qual este filtro se aplica. Pode ser 0-255 ou um dos seguintes: TCP, UDP.

LocalAddresses

Tipo de dados: string[]

Tipo de acesso: leitura/gravação

Uma matriz de endereços IP, sub-redes ou intervalos. Os formatos válidos incluem: um endereço IPv4 válido em notação decimal pontilhada estrita de quatro partes (por exemplo, 10.0.0.10), um endereço IPv6 válido no formato padrão da Internet, conforme descrito na seção 2.2 da RFC 4291 (por exemplo, 2620:1ec:c11::200), um intervalo de endereços IPv4 no formato de 'endereço inicial - endereço final' sem espaços incluídos (por exemplo, 10.0.0.0-10.0.0.255), um intervalo de endereços IPv6 no formato de 'endereço inicial - endereço final' sem espaços incluídos (por exemplo, 2001:db8:abcd:12::-2001:db8:abcd:12:ffff:ffff:ffff:ffff:ffff), uma sub-rede IPv4 válida especificada usando a notação de prefixo de rede (por exemplo, 10.0.0.0/24), uma sub-rede IPv6 válida especificada usando a notação de comprimento de prefixo (por exemplo, 2001: db8:abcd:0012::/64)".

LocalPorts

Tipo de dados: string[]

Tipo de acesso: leitura/gravação

Portas locais às quais esse filtro se aplica (aplica-se somente quando o protocolo é TCP ou UDP). Pode ser um número ou intervalo 0-65535 ou um dos seguintes: Any, RPC, RPC-EPMap, IPHTTPSIn, PlayToDiscovery.

RemoteAddresses

Tipo de dados: string[]

Tipo de acesso: leitura/gravação

RemotePorts

Tipo de dados: string[]

Tipo de acesso: leitura/gravação

Portas remotas às quais esse filtro se aplica (aplica-se somente quando o protocolo é TCP ou UDP). Pode ser um número ou intervalo 0-65535, ou um dos seguintes: Qualquer, IPHTTPSOut.

Action

Tipo de dados: uint16

Tipo de acesso: leitura/gravação

Especifica a ação a ser executada no tráfego que corresponde a essa regra.

Permitir (2)

Bloco (4)

EnforcementStatus

Tipo de dados: uint16

Tipo de acesso: leitura/gravação

Descreve o status de imposição atual desta regra.

Inválido (0)

Totalmente Aplicado (1)

Parcialmente Executado (2)

NoApplicablePorts (3)

ParsingError (4)

Erro (5)

PolicyStoreSourceType

Tipo de dados: uint16

Tipo de acesso: leitura/gravação

Descreve o tipo de PolicyStore de onde essa regra veio originalmente.

Desconhecido (0)

Local (1)

Dinâmico (3)

Gerado (5)

MDM (6)

HostFirewallLocal (8)

HostFirewallGroupPolicy (9)

HostFirewallDinâmico (10)

HostFirewallMDM (11)

PortStatuses

Tipo de dados: string[]

Tipo de acesso: leitura/gravação

Lista de status para cada porta à qual essa regra foi aplicada.

Profiles

Tipo de dados: uint16

Tipo de acesso: leitura/gravação

Bitmask de perfis nos quais esta regra está ativa.

Qualquer (0)

Público (0x4)

Privado (0x2)

Domínio (0x1)

SystemCreationClassName

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Reservado apenas para uso interno pelo provedor WMI.

SystemName

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Reservado apenas para uso interno pelo provedor WMI.

CreationClassName

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Reservado apenas para uso interno pelo provedor WMI.

PolicyRuleName

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Reservado apenas para uso interno pelo provedor WMI.

ConditionListType

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Este campo é ignorado.

RuleUsage

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Este campo é ignorado.

Priority

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Este campo é ignorado.

Mandatory

Tipo de dados: boolean

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Este campo é ignorado.

SequencedActions

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Este campo é ignorado.

ExecutionStrategy

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Este campo é ignorado.

PolicyDecisionStrategy

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Este campo é ignorado.

PolicyRoles

Tipo de dados: string[]

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Este campo é ignorado.

Profiles

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Indica se essa regra está habilitada ou desabilitada administrativamente. O valor padrão é "1" (Habilitado).

Habilitado (1)

Desabilitado (2)

CommonName

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Este campo é ignorado.

PolicyKeywords

Tipo de dados: string[]

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Este campo é ignorado.

InstanceID

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Substituir

Uma cadeia de caracteres que identifica exclusivamente essa instância no PolicyStore.

Caption

Tipo de dados: string

Tipo de acesso: Somente leitura

Eliminatórias: Override, MaxLen (64)

A propriedade Caption é uma breve descrição textual (uma cadeia de caracteres de uma linha) do objeto.

Description

Tipo de dados: string

Tipo de acesso: leitura/gravação

Qualificadores: Substituir

Uma breve descrição da regra. Pode ser uma cadeia de caracteres indireta. Se for uma cadeia de caracteres indireta, talvez não seja substituída.

ElementName

Tipo de dados: string

Tipo de acesso: leitura/gravação

Qualificadores: Substituir

O nome independente de localidade da regra. Pode ser uma cadeia de caracteres indireta.

Requisitos


Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Namespace	Raiz\StandardCimv2
MOF	WFasCim.mof
DLL	WFasCim.dll

Compartilhar via

MSFT_NetFirewallHyperVRule classe

Sintaxe

Membros

Métodos

Propriedades

Requisitos

Comentários

Recursos adicionais