Classe MSFT_NetFirewallHyperVRule

Articolo
05/18/2024

Rappresenta una regola Hyper-V di Windows Defender Firewall.

Per altre informazioni, vedere la documentazione di PowerShell New-NetFirewallHyperVRule.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate.

Sintassi

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;
};

Membri

La classe MSFT_NetFirewallHyperVRule ha questi tipi di membri:

Metodi
Proprietà

Metodi

La classe MSFT_NetFirewallHyperVRule dispone di questi metodi.

metodo	Descrizione
Disabilita	Disabilitare questa regola.
Abilitazione	Abilitare questa regola.
EnumerateFull	Enumera tutti i campi di tutte le regole.
Rinomina	Rinominare questa regola.

Proprietà

La classe MSFT_NetFirewallHyperVRule ha queste proprietà.

DisplayName

Tipo di dati: string

Tipo di accesso: sola lettura

Nome localizzato di questa regola. Il valore di questo campo si basa sul valore di ElementName. Le modifiche apportate a questo campo vengono ignorate.

RulePriority

Tipo di dati: uint16

Tipo di accesso: lettura/scrittura

Determina l'ordine in cui vengono valutate le regole. Le regole con priorità inferiore vengono valutate per prime. Se questo valore è 0 (unset), il sistema assegnerà il valore 1 alle regole con azione Blocca e 2 a regole con l'azione Consenti.

Direction

Tipo di dati: uint16

Tipo di accesso: lettura/scrittura

Specifica la direzione del traffico da associare a questa regola.

In ingresso (1)

In uscita (2)

VMCreatorId

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Specifica l'identificatore univoco dell'autore della macchina virtuale a cui è applicabile questa regola. Un valore GUID NULL indica che questa regola è applicabile a tutte le porte Hyper-V nel sistema.

Protocol

Tipo di dati: string

Tipo di accesso: lettura/scrittura

IANA Internet Protocol Number a cui si applica questo filtro. Può essere 0-255 o uno dei seguenti: TCP, UDP.

LocalAddresses

Tipo di dati: string[]

Tipo di accesso: lettura/scrittura

Matrice di indirizzi IP, subnet o intervalli. I formati validi includono: un indirizzo IPv4 valido in formato decimale a quattro parti rigoroso (ad esempio, 10.0.0.10), un indirizzo IPv6 valido in formato standard Internet, come descritto nella sezione 2.2 di RFC 4291 (ad esempio, 2620:1ec:c11::200), un intervallo di indirizzi IPv4 nel formato di "indirizzo iniziale - indirizzo finale" senza spazi inclusi (ad esempio, 10.0.0.0-10.0.0.0.255), Un intervallo di indirizzi IPv6 nel formato "indirizzo iniziale - indirizzo finale" senza spazi inclusi (ad esempio, 2001:db8:abcd:12::-2001:db8:abcd:12:ffff:ffff:ffff:ff), una subnet IPv4 valida specificata usando la notazione del prefisso di rete (ad esempio, 10.0.0.0/24), una subnet IPv6 valida specificata usando la notazione di lunghezza del prefisso (ad esempio, 2001: db8:abcd:0012::/64)".

LocalPorts

Tipo di dati: string[]

Tipo di accesso: lettura/scrittura

Porte locali a cui si applica questo filtro (si applica solo quando Protocollo è TCP o UDP). Può essere un numero o un intervallo compreso tra 0 e 65535 o uno dei seguenti: Any, RPC, RPC-EPMap, IPHTTPSIn, PlayToDiscovery.

RemoteAddresses

Tipo di dati: string[]

Tipo di accesso: lettura/scrittura

RemotePorts

Tipo di dati: string[]

Tipo di accesso: lettura/scrittura

Porte remote a cui si applica questo filtro (si applica solo quando Protocollo è TCP o UDP). Può essere un numero o un intervallo compreso tra 0 e 65535 o uno dei seguenti: Any, IPHTTPSOut.

Action

Tipo di dati: uint16

Tipo di accesso: lettura/scrittura

Specifica l'azione da eseguire sul traffico che corrisponde a questa regola.

Consenti (2)

Blocco (4)

EnforcementStatus

Tipo di dati: uint16

Tipo di accesso: lettura/scrittura

Descrive lo stato di imposizione corrente di questa regola.

Non valido (0)

FullyEnforced (1)

ParzialmenteEnforced (2)

NoApplicablePorts (3)

ParsingError (4)

Errore (5)

PolicyStoreSourceType

Tipo di dati: uint16

Tipo di accesso: lettura/scrittura

Descrive il tipo di PolicyStore da cui proviene originariamente questa regola.

Sconosciuto (0)

Locale (1)

Dinamico (3)

Generato (5)

MDM (6)

HostFirewallLocal (8)

HostFirewallGroupPolicy (9)

HostFirewallDynamic (10)

HostFirewallMDM (11)

PortStatuses

Tipo di dati: string[]

Tipo di accesso: lettura/scrittura

Elenco di stati per ogni porta a cui è stata applicata questa regola.

Profiles

Tipo di dati: uint16

Tipo di accesso: lettura/scrittura

Maschera di bit dei profili su cui questa regola è attiva.

Qualsiasi (0)

Pubblico (0x4)

Privato (0x2)

Dominio (0x1)

SystemCreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override

Riservato solo per uso interno da parte del provider WMI.

SystemName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override

Riservato solo per uso interno da parte del provider WMI.

CreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override

Riservato solo per uso interno da parte del provider WMI.

PolicyRuleName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override

Riservato solo per uso interno da parte del provider WMI.

ConditionListType

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: Override

Questo campo viene ignorato.

RuleUsage

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override

Questo campo viene ignorato.

Priority

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: Override

Questo campo viene ignorato.

Mandatory

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: Override

Questo campo viene ignorato.

SequencedActions

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: Override

Questo campo viene ignorato.

ExecutionStrategy

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: Override

Questo campo viene ignorato.

PolicyDecisionStrategy

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: Override

Questo campo viene ignorato.

PolicyRoles

Tipo di dati: string[]

Tipo di accesso: sola lettura

Qualificatori: Override

Questo campo viene ignorato.

Profiles

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: Override

Indica se questa regola è abilitata o disabilitata in modo amministrativo. Il valore predefinito è "1" (Abilitato).

Abilitato (1)

Disabilitato (2)

CommonName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override

Questo campo viene ignorato.

PolicyKeywords

Tipo di dati: string[]

Tipo di accesso: sola lettura

Qualificatori: Override

Questo campo viene ignorato.

InstanceID

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override

Stringa che identifica in modo univoco questa istanza all'interno di PolicyStore.

Caption

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override, MaxLen (64)

La proprietà Caption è una breve descrizione testuale (una stringa di una riga) dell'oggetto .

Description

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Qualificatori: Override

Breve descrizione della regola. Potrebbe essere una stringa indiretta. Se si tratta di una stringa indiretta, potrebbe non essere sovrascritto.

ElementName

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Qualificatori: Override

Nome indipendente dalle impostazioni locali della regola. Potrebbe essere una stringa indiretta.

Requisiti


Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Spazio dei nomi	Root\StandardCimv2
MOF	WFasCim.mof
DLL	WFasCim.dll

Condividi tramite

Classe MSFT_NetFirewallHyperVRule

Sintassi

Membri

Metodi

Proprietà

Requisiti

Commenti e suggerimenti

Risorse aggiuntive