Freigeben über

Set-SCPortACLRule

  • Referenz
Modul:
VirtualMachineManager

Ändert eine ACL-Portregel.

Syntax

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>]

Beschreibung

Das Cmdlet Set-SCPortACLRule ändert eine ACL-Regel (Port Access Control List) in Virtual Machine Manager (VMM).

Beispiele

Beispiel 1: Ändern der Priorität der Port-ACL-Regel

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

Der erste Befehl ruft die Port-ACL-Regel mit dem Namen AllowRDPAccess ab und speichert sie dann in der $PortACLRule Variablen.

Der zweite Befehl ändert die Priorität der Regel in $PortACLRule in 220.

Beispiel 2: Ändern des Remoteadressenbereichs und des Protokolls für die Port-Acl-Regel

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

Der erste Befehl ruft die Port-ACL-Regel mit dem Namen AllowRDPAccess ab und speichert sie dann in der $PortACLRule Variablen.

Der zweite Befehl ändert das Protokoll der ACL-Regel in $PortACLRule in UDP und legt den Remoteadressenbereich auf ein anderes Subnetz fest.

Parameter

-Action

Gibt ein Port-ACL-Regelaktionsobjekt an.

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

-Description

Gibt eine Beschreibung für die Port-ACL-Regel an.

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-LocalAddressPrefix

Gibt das lokale Adresspräfix an.

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

-LocalPortRange

Gibt den lokalen Portbereich an.

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

-Name

Gibt den Namen der Port-ACL-Regel an.

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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

-PortACLRule

Gibt die zu ändernde Port-ACL-Regel an.

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

-Priority

Gibt die Priorität an.

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

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-Protocol

Gibt das Protokoll an. Zulässige Werte für diesen Parameter:

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

-RemoteAddressPrefix

Gibt das Präfix der Remoteadresse an.

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

-RemotePortRange

Gibt den Remoteportbereich an.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-Type

Gibt den Typ an. Zulässige Werte für diesen Parameter:

  • Eingehend
  • Ausgehend
Type:PortACLRuleDirection
Accepted values:Inbound, Outbound
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

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