Set-AzureAclConfig

Referenz

Modul:: Azure

Ändert ein ACL-Konfigurationsobjekt.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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.

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

-Action

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

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

-AddRule

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

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

-Description

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

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

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

Fortfahren
Ignorieren
Fragen
SilentlyContinue
Beenden
Angehalten

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Gibt eine Informationsvariable an.

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

-Order

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

Type:	Int32
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoteSubnet

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

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

-RemoveRule

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

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

-RuleId

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

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

-SetRule

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

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