Partager via

Set-SCPortACLRule

  • Référence
Module:
VirtualMachineManager

Modifie une règle de liste de contrôle d’accès de port.

Syntaxe

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

L’applet de commande set-SCPortACLRule modifie une règle de liste de contrôle d’accès de port (ACL) dans Virtual Machine Manager (VMM).

Exemples

Exemple 1 : Modifier la priorité de règle de liste de contrôle d’accès du port

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

La première commande obtient la règle ACL de port nommée AllowRDPAccess, puis la stocke dans la variable $PortACLRule.

La deuxième commande modifie la priorité de la règle dans $PortACLRule à 220.

Exemple 2 : Modifier la plage d’adresses et le protocole distants de la règle acl de port

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

La première commande obtient la règle ACL de port nommée AllowRDPAccess, puis la stocke dans la variable $PortACLRule.

La deuxième commande modifie le protocole de la règle de liste de contrôle d’accès dans $PortACLRule en UDP et définit la plage d’adresses distante sur un autre sous-réseau.

Paramètres

-Action

Spécifie un objet d’action de règle de liste de contrôle d’accès du port.

Type:PortACLRuleAction
Valeurs acceptées:Allow, Deny
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifie une description de la règle de liste de contrôle d’accès du port.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LocalAddressPrefix

Spécifie le préfixe d’adresse locale.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LocalPortRange

Spécifie la plage de ports locale.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom de la règle de liste de contrôle d’accès du port.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OnBehalfOfUser

Spécifie un nom d’utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet Get-SCUserRole. Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

Type:UserRole
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PortACLRule

Spécifie la règle de liste de contrôle d’accès du port à modifier.

Type:PortACLRule
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Priority

Spécifie la priorité.

Type:UInt16
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Protocol

Spécifie le protocole. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Tcp
  • Udp
  • Quelconque
Type:PortACLRuleProtocol
Valeurs acceptées:Tcp, Udp, Any
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemoteAddressPrefix

Spécifie le préfixe d’adresse distante.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemotePortRange

Spécifie la plage de ports distante.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Type

Spécifie le type. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Entrants
  • Sortants
Type:PortACLRuleDirection
Valeurs acceptées:Inbound, Outbound
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False