Set-AzureAclConfig

  • Referenz
Modul:
Azure

Ändert ein ACL-Konfigurationsobjekt.

Hinweis

Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service Manager (ASM)-APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

Set-AzureAclConfig
   [-AddRule]
   [-Action] <String>
   [-RemoteSubnet] <String>
   [[-Order] <Int32>]
   [[-Description] <String>]
   -ACL <NetworkAclObject>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureAclConfig
   [-RemoveRule]
   [-RuleId] <Int32>
   -ACL <NetworkAclObject>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureAclConfig
   [-SetRule]
   [-RuleId] <Int32>
   [[-Action] <String>]
   [[-RemoteSubnet] <String>]
   [[-Order] <Int32>]
   [[-Description] <String>]
   -ACL <NetworkAclObject>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Set-AzureAclConfig " wird ein Konfigurationsobjekt für die Zugriffssteuerungsliste (Access Control List, ACL) von einer vorhandenen Konfiguration eines virtuellen Azure-Computers geändert.

Beispiele

Beispiel 1: Hinzufügen einer Regel zu einer neuen ACL-Konfiguration

PS C:\> $Acl = New-AzureAclConfig
PS C:\> Set-AzureAclConfig -AddRule -ACL $Acl -Action Permit -RemoteSubnet "172.0.0.0/8" -Order 100 -Description "Permit ACL rule"

Der erste Befehl erstellt eine ACL-Konfiguration und speichert sie dann in der $Acl Variablen.

Mit dem zweiten Befehl wird der in $Acl gespeicherten Konfiguration eine neue Regel hinzugefügt. Der Befehl gibt eine Aktion, ein Subnetz, eine Reihenfolge und eine Beschreibung für die Regel an.

Beispiel 2: Ändern einer Regel in einer ACL-Konfiguration

PS C:\> $Acl = Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Get-AzureAclConfig -EndpointName "Web"
PS C:\> Set-AzureAclConfig -SetRule -RuleId 0 -ACL $Acl -Order 102 -Description "Web endpoint rule"
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Set-AzureEndpoint -ACL $Acl -Name "Web" | Update-AzureVM

Der erste Befehl ruft den virtuellen Computer "VirtualMachine07" im Dienst "ContosoService" mithilfe des Cmdlets "Get-AzureVM " ab. Der Befehl übergibt dieses Objekt mithilfe des Pipelineoperators an das Cmdlet "Get-AzureAclConfig ". Dieses Cmdlet ruft die ACL-Konfiguration für den Endpunkt mit dem Namen "Web" ab. Der Befehl speichert das ACL-Konfigurationsobjekt in der $Acl Variablen.

Der zweite Befehl ändert die Regel mit der ID 0. Der Befehl ändert die Reihenfolge und die Beschreibung der Regel.

Der letzte Befehl legt das ACL-Konfigurationsobjekt für diesen virtuellen Computer mithilfe des Cmdlets Set-AzureEndpoint fest. Der Befehl aktualisiert auch diesen virtuellen Computer.

Beispiel 3: Entfernen einer Regel aus einer ACL-Konfiguration

PS C:\> $Acl = Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Get-AzureAclConfig -EndpointName "Web"
PS C:\> Set-AzureAclConfig -RemoveRule -ID 0 -ACL $Acl
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Set-AzureEndpoint -ACL $Acl -Name "Web" | Update-AzureVM

Der erste Befehl speichert ein ACL-Konfigurationsobjekt in der variablen $Acl. Dies ist identisch mit dem vorherigen Beispiel.

Der zweite Befehl entfernt die Regel mit der ID 0 aus der ACL-Konfiguration in $Acl.

Der letzte Befehl legt das ACL-Konfigurationsobjekt für den virtuellen Computer fest und aktualisiert diesen virtuellen Computer. Dies ist identisch mit dem vorherigen Beispiel.

Parameter

-ACL

Gibt ein ACL-Konfigurationsobjekt an, das dieses Cmdlet ändert.

Typ:NetworkAclObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Action

Gibt die Aktion für die Regel an, die dieses Cmdlet hinzufügt oder ändert. Gültige Werte sind: Permit and Deny.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AddRule

Gibt an, dass dieses Cmdlet der ACL-Konfiguration eine Regel hinzufügt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für die Regel an, die dieses Cmdlet hinzufügt oder ändert.

Typ:String
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Weiter
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Order

Gibt die Verarbeitungsreihenfolge für die Regel an, die dieses Cmdlet hinzufügt oder ändert.

Typ:Int32
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoteSubnet

Gibt das Remotesubnetz für die Regel an, die dieses Cmdlet hinzufügt oder ändert. Gibt eine Adresse im klassenloses domänenübergreifendes Routing -Format (CIDR) an.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveRule

Gibt an, dass dieses Cmdlet eine Regel aus der ACL-Konfiguration entfernt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RuleId

Gibt die ID der Regel an, die dieses Cmdlet für die ACL-Konfiguration entfernt oder ändert.

Typ:Int32
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SetRule

Gibt an, dass dieses Cmdlet eine Regel in der ACL-Konfiguration ändert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False