EAAS/NFV>> PowerArubaCX>> 返回
项目作者： PowerAruba

项目描述 ：
PowerShell module to manage ArubaCX switches
高级语言： PowerShell
项目地址: git://github.com/PowerAruba/PowerArubaCX.git
创建时间： 2018-07-26T15:01:01Z
项目社区：https://github.com/PowerAruba/PowerArubaCX
开源协议：Apache License 2.0
下载


PowerArubaCX



















This is a Powershell module for configure an ArubaCX Switch.



With this module (version 0.6.0) you can manage:

There is some extra feature

More functionality will be added later.

Tested with ArubaCX 8400 and 832x, 6x00 (using >= 10.06.xx firmware) on Windows/Linux/macOS

Usage

All resource management functions are available with the Powershell verbs GET, ADD, SET, REMOVE.

For example, you can manage Vlans with the following commands:

  • Get-ArubaCXVlans
  • Add-ArubaCXVlans
  • Set-ArubaCXVlans
  • Remove-ArubaCXVlans

Requirements

  • Powershell 7 (Core) or 5 (If possible get the latest version)
  • An ArubaCX Switch (with firmware >= 10.06.xx) and REST API enable

Instructions

Install the module

  1. # Automated installation (Powershell 5 and later):
  2.     Install-Module PowerArubaCX
  4. # Import the module
  5.     Import-Module PowerArubaCX
  7. # Get commands in the module
  8.     Get-Command -Module PowerArubaCX
  10. # Get help
  11.     Get-Help Invoke-ArubaCXRestMethod -Full

Examples

Connecting to the Aruba Switch

The first thing to do is to connect to an ArubaCX Switch with the command Connect-ArubaCX:

  1. # Connect to the Aruba CX Switch
  2.     Connect-ArubaCX 192.0.2.1
  4. #we get a prompt for credential

Vlans Management

You can create a new Vlan Add-ArubaCXVlans, retrieve its information Get-ArubaCXVlans, modify its properties Set-ArubaCXVlans, or delete it Remove-ArubaCXVlans.

  1. # Create a vlan
  2.     Add-ArubaCXVlans -id 85 -Name 'PowerArubaCX'
  4.     [...]
  5.     admin                             : up
  6.     clear_ip_bindings                 :
  7.     description                       :
  8.     [...]
  9.     id                                : 85
  10.     [...]
  11.     name                              : PowerArubaCX
  12.     nd_snoop_config                   : @{enable=False; ra_drop_enable=False}
  13.     nd_snooping_prefix                : {}
  14.     oper_state                        : down
  15.     oper_state_reason                 : no_member_port
  16.     [...]
  17.     type                              : static
  18.     voice                             : False
  19.     vsx_sync                          : {}
  22. # Get information about vlan
  23.     Get-ArubaCXVlans -id 85 -attributes admin, description, id, name, type, voice | Format-Table
  25.     admin description id name         type   voice
  26.     ----- ----------- -- ----         ----   -----
  27.     up                85 PowerArubaCX static False
  29. # Change settings of a vlan (Description and voice)
  30.     Get-ArubaCXVlans -id 85 | Set-ArubaCXVlans -description "Add via PowerArubaCX" -voice
  32.     [...]
  33.     admin                             : up
  34.     clear_ip_bindings                 :
  35.     description                       : Add via PowerArubaCX
  36.     [...]
  37.     id                                : 85
  38.     [...]
  39.     name                              : PowerArubaCX
  40.     nd_snoop_config                   : @{enable=False; ra_drop_enable=False}
  41.     nd_snooping_prefix                : {}
  42.     oper_state                        : down
  43.     oper_state_reason                 : no_member_port
  44.     [...]
  45.     type                              : static
  46.     voice                             : True
  47.     vsx_sync                          : {}
  50. # Remove a vlan
  51.     Get-ArubaCXVlans -name PowerArubaCX | Remove-ArubaCXVlans

For configure a vlan to an interface, need to use Set-ArubaCXInterfaces

Invoke API

for example to get ArubaCX System Configuration

  1. # get Aruba CX System configuration using API
  2.     Invoke-ArubaCXRestMethod -method "get" -uri "system" -selector configuration
  4.     aaa                                : @{fail_through=False; login_lockout_time=300; radius_auth=pap; radius_retries=1;
  5.                                         radius_timeout=5; ssh_passkeyauthentication_enable=True;
  6.                                         ssh_publickeyauthentication_enable=True; tacacs_auth=pap; tacacs_timeout=5}
  7.     all_user_copp_policies             : {}
  8.     arp_config                         : @{gc_threshold=131072; timeout=30}
  9.     bfd_detect_multiplier              : 5
  10.     bfd_echo_disable                   : False
  11.     bfd_enable                         : False
  12.     bfd_min_echo_rx_interval           : 500
  13.     bfd_min_rx_interval                : 3000
  14.     bfd_min_tx_interval                : 3000
  15.     checkpoint_post_config             : @{disable=False; timeout=300}
  16.     dhcp_config                        :
  17.     dlog_destination                   :
  18.     dns_servers                        : {}
  19.     ecmp_config                        :
  20.     hostname                           : PowerArubaCX-SW1
  21.     hpe_rda_enable                     : False
  22.     icmp_redirect_disable              : False
  23.     icmp_unreachable_disable           : False
  24.     icmp_unreachable_ratelimit         : 1000
  26. [...]
  27. # get only Aruba CX System hostname and dns servers
  28.     Invoke-ArubaCXRestMethod -method "get" -uri "system" -attributes hostname, dns_servers
  30.     dns_servers hostname
  31.     ----------- --------
  32.     {}          PowerArubaCX-SW1

to get API uri, go to ArubaCX Swagger (https://ArubaCX-IP/api/v10.04/)

And choice a service (for example System)

Interface

On ArubaCX, on interface, there is all type of interface physical/system and virtual (LAG, Loopback, Vlans)

You can create a new interface (LAG, Loopback, Vlans) Add-ArubaCXInterfaces, retrieve its information Get-ArubaCXInterfaces, modify its properties Set-ArubaCXInterfaces or delete it Remove-ArubaCXInterfaces. There is also extra cmdlets for Add Add-ArubaCXInterfacesVlansTrunks / Remove Remove-ArubaCXInterfacesVlansTrunks Vlans trunks on interface (physical or LAG) or for Add Add-ArubaCXInterfacesLagInterface or Remove Remove-ArubaCXInterfacesLagInterface member (physical) interface on LAG.

Interface Physical (System)

  2. #Get interface 1/1/1 configuration
  3.     Get-ArubaCXInterfaces 1/1/1 -selector configuration
  5.     aaa_auth_precedence                  :
  6.     aclmac_in_cfg                        :
  7.     aclmac_in_cfg_version                :
  8.     aclmac_out_cfg                       :
  9.     aclmac_out_cfg_version               :
  10.     aclv4_in_cfg                         :
  11.     aclv4_in_cfg_version                 :
  12.     aclv4_out_cfg                        :
  13.     aclv4_out_cfg_version                :
  14.     aclv6_in_cfg                         :
  15.     aclv6_in_cfg_version                 :
  16.     aclv6_out_cfg                        :
  17.     aclv6_out_cfg_version                :
  18.     admin                                : up
  19.     [...]
  21. #Get name, admin state and link state of interface
  23.     Get-ArubaCXInterfaces 1/1/1 -attributes name, admin_state, link_state
  25.     admin_state link_state name
  26.     ----------- ---------- ----
  27.     down        down       1/1/1
  29. #Configure interface 1/1/1 (Description, admin and routing)
  31.     Get-ArubaCXInterfaces 1/1/1 | Set-ArubaCXInterfaces -description "Changed by PowerArubaCX" -admin up -routing:$false
  33.     [...]
  34.     admin                                   : up
  35.     [...]
  36.     description                             : Changed by PowerArubaCX
  37.     [...]
  38.     name                                    : 1/1/1
  39.     [...]
  40.     routing                                 : False
  41.     [...]
  43. #Configure interface 1/1/1 on vlan access 85
  45.     Get-ArubaCXInterfaces -interface 1/1/1 | Set-ArubaCXInterfaces -vlan_mode access -vlan_tag 85
  47.     name                                    : 1/1/1
  48.     [...]
  49.     vlan_mode                               : access
  50.     vlan_tag                                : @{85=/rest/v10.04/system/vlans/85}
  51.     [...]
  53. #Configure interface 1/1/1 on native-untagged mode with vlan 85 and tagged vlan 44
  55.     Get-ArubaCXInterfaces -interface 1/1/1 | Set-ArubaCXInterfaces -vlan_mode native-untagged -vlan_tag 85 -vlan_trunks 44
  57.     name                                    : 1/1/1
  58.     [...]
  59.     vlan_mode                               : native-untagged
  60.     vlan_tag                                : @{85=/rest/v10.04/system/vlans/85}
  61.     vlan_trunks                             : @{44=/rest/v10.04/system/vlans/44}
  63. #Configure interface 1/1/1 and add vlan 45 to trunks
  65.     Get-ArubaCXInterfaces -interface 1/1/1 | Add-ArubaCXInterfacesVlanTrunks -vlan_trunks 45
  67.     name                                    : 1/1/1
  68.     [...]
  69.     vlan_mode                               : native-untagged
  70.     vlan_tag                                : @{85=/rest/v10.04/system/vlans/85}
  71.     vlan_trunks                             : @{44=/rest/v10.04/system/vlans/44; 45=/rest/v10.04/system/vlans/45}
  72.     [...]
  74. #Configure interface 1/1/1 with a IPv4 address
  76.     Get-ArubaCXInterfaces -interface 1/1/1 | Set-ArubaCXInterfaces -ip4_address 192.0.2.1 -ip4_mask 24
  78.     name                                    : 1/1/1
  79.     [...]
  80.     ip4_address                             : 192.0.2.1/24
  81.     [...]

Interface LAG

  2. #Add LAG 1 with member interface 1/1/1
  4.     Add-ArubaCXInterfaces -lag_id 1 admin up -interfaces 1/1/3 -lacp active
  6.     name                                    : lag1
  7.     [...]
  8.     interfaces                              : @{1/1/3=/rest/v10.09/system/interfaces/1%2F1%2F3}
  9.     [...]
  10.     lacp                                    : active
  11.     [...]
  13. #Configure Access vlan 44 on LAG 1
  15.     Get-ArubaCXInterfaces lag1 | Set-ArubaCXInterfaces -vlan_tag 44 -vlan_mode access
  17.     name                                    : lag1
  18.     [...]
  19.     vlan_mode                               : access
  20.     vlan_tag                                : @{44=/rest/v10.09/system/vlans/44}
  21.     [...]
  23. #Configure Trunk vlan 44,45 on LAG 1
  25.     Get-ArubaCXInterfaces lag1 | Set-ArubaCXInterfaces -vlan_tag 1 -vlan_trunks 44,45 -vlan_mode native-untagged 
  27.     name                                    : lag1
  28.     [...]
  29.     vlan_mode                               : native-untagged
  30.     vlan_tag                                : @{1=/rest/v10.09/system/vlans/1}
  31.     vlan_trunks                             : @{44=/rest/v10.09/system/vlans/44; 45=/rest/v10.09/system/vlans/45}
  32.     [...]
  34. #Add interface 1/1/2 on LAG 1
  36.     Get-ArubaCXInterfaces lag1 | Add-ArubaCXInterfacesLagInterfaces -interfaces 1/1/2
  38.     name                                    : lag1
  39.     [...]
  40.     interfaces                              : @{1/1/2=/rest/v10.09/system/interfaces/1%2F1%2F2; 1/1/3=/rest/v10.09/system/interfaces/1%2F1%2F3}
  41.     [...]
  42.     lacp                                    : active
  43.     [...]
  45. #Remove interface 1/1/3 on LAG 1
  47.     Get-ArubaCXInterfaces lag1 | Remove-ArubaCXInterfacesLagInterfaces -interfaces 1/1/3
  49.     name                                    : lag1
  50.     [...]
  51.     interfaces                              : @{1/1/2=/rest/v10.09/system/interfaces/1%2F1%2F2}
  52.     [...]
  53.     lacp                                    : active
  54.     [...]
  56. #Remove LAG 1
  58.     Get-ArubaCXInterfaces lag1 | Remove-ArubaCXInterfaces
  60.     Confirm
  61.     Are you sure you want to perform this action?
  62.     Performing the operation "Remove interface" on target "lag1".
  63.     [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Interface Loopback

  2. #Add interface loopback 1 with a IPv4 Address (you need to add vlan before)
  4.     Add-ArubaCXInterfaces -loopback_id 1 -ip4_address 192.0.2.44 -ip4_mask 24
  6.     name                                    : loopback1
  7.     [...]
  8.     active_ip4_address                      : 192.0.2.44/24
  9.     [...]
  10.     ip4_address                             : 192.0.2.44/24
  11.     [...]
  13. #Change IP Address of interface loopback 1
  15.     Get-ArubaCXInterfaces loopback1 | Set-ArubaCXInterfaces -ip4_address 192.0.2.254 -ip4_mask 24
  17.     name                                    : loopback1
  18.     [...]
  19.     active_ip4_address                      : 192.0.2.254/24
  20.     [...]
  21.     ip4_address                             : 192.0.2.254/24
  22.     [...]
  24. #Set VRF Blue on interface loopback 1(need to create vrf before)
  26.     Get-ArubaCXInterfaces loopback1 | Set-ArubaCXInterfaces -vrf blue
  28.     name                                    : loopback1
  29.     [...]
  30.     vrf                                     : @{blue=/rest/v10.09/system/vrfs/blue}
  31.     [...]
  33. #Remove interface loopback 1
  35.     Get-ArubaCXInterfaces loopback1 | Remove-ArubaCXInterfaces
  37.     Confirm
  38.     Are you sure you want to perform this action?
  39.     Performing the operation "Remove interface" on target "loopback1".
  40.     [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Interface Vlans

  2. #Add interface vlan 44 with a IPv4 Address (you need to add vlan before)
  4.     Add-ArubaCXInterfaces -vlan_id 44 -ip4_address 192.0.2.44 -ip4_mask 24
  6.     name                                    : vlan44
  7.     [...]
  8.     active_ip4_address                      : 192.0.2.44/24
  9.     [...]
  10.     ip4_address                             : 192.0.2.44/24
  11.     [...]
  13. #Change IP Address of interface vlan 44
  15.     Get-ArubaCXInterfaces vlan44 | Set-ArubaCXInterfaces -ip4_address 192.0.2.254 -ip4_mask 24
  17.     name                                    : vlan44
  18.     [...]
  19.     active_ip4_address                      : 192.0.2.254/24
  20.     [...]
  21.     ip4_address                             : 192.0.2.254/24
  22.     [...]
  24. #Set VRF Blue on interface vlan 44 (need to create vrf before)
  26.     Get-ArubaCXInterfaces vlan44 | Set-ArubaCXInterfaces -vrf blue
  28.     name                                    : vlan44
  29.     [...]
  30.     vrf                                     : @{blue=/rest/v10.09/system/vrfs/blue}
  31.     [...]
  33. #Remove interface vlan 44
  35.     Get-ArubaCXInterfaces vlan44 | Remove-ArubaCXInterfaces
  37.     Confirm
  38.     Are you sure you want to perform this action?
  39.     Performing the operation "Remove interface" on target "vlan44".
  40.     [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

LLDP Neighbor

  2. #Get LLDP Neighbor of All Ports
  4.     Get-ArubaCXLLDPNeighbor
  6.     %2F1%2F8                                                                                                                1%2F1%2F9
  7.     ---------                                                                                                                ---------
  8.     @{08:00:09:0d:2d:06,1/1/9=/rest/v10.09/system/interfaces/1%2F1%2F8/lldp_neighbors/08%3A00%3A09%3A0d%3A2d%3A06,1%2F1%2F9} @{08:00:09:0d:2d:06,1/1/8=/rest/v10.09/system/interfaces/1%2F1%2F9/lldp_neighbors/08%3A00%3A09%3…
  10. #Get LLDP Neighbor of port 1/1/8 with depth 2
  12.     Get-ArubaCXLLDPNeighbor 1/1/8 -depth 2
  14.     08:00:09:0d:2d:06,1/1/9
  15.     -----------------------
  16.     @{chassis_id=08:00:09:0d:2d:06; dcbx_cee_status=; mac_addr=08:00:09:0d:2d:06; med_network_policy=; neighbor_info=; neighbor_info_organizational=; port_id=1/1/9}
  18. #To Get all info, you can use
  20.     (Get-ArubaCXLLDPNeighbor 1/1/8 -depth 2).'08:00:09:0d:2d:06,1/1/9'
  22.     chassis_id                   : 08:00:09:0d:2d:06
  23.     dcbx_cee_status              :
  24.     mac_addr                     : 08:00:09:0d:2d:06
  25.     med_network_policy           :
  26.     neighbor_info                : @{associated_poe_tlv_for_pd=dot3; chassis_capability_available=Bridge, Router; chassis_capability_enabled=Bridge, Router; chassis_description=Aruba ABC123  Virtual.10.09.0002;
  27.                                 chassis_id_len=6; chassis_id_subtype=link_local_addr; chassis_index=1; chassis_name=switch; chassis_protocol=LLDP; chassis_refcount=2; chassis_ttl=120; eee_wake_time_fallback=0;
  28.                                 eee_wake_time_rx=0; eee_wake_time_rx_echo=0; eee_wake_time_tx=0; eee_wake_time_tx_echo=0; macphy_autoneg_advertised=Other; macphy_autoneg_enabled=0; macphy_autoneg_support=0;
  29.                                 macphy_mau_type= ; mgmt_iface_list=33554433; mgmt_iface_oid_list=1.3.6.1.2.1.31.1.1.1.1.33554433; mgmt_ip_list=192.0.2.44; pd_dot3_ext_tlv_advertised=False; pd_dot3_tlv_advertised=False;
  30.                                 pd_med_tlv_advertised=False; port_description=1/1/9; port_hidden_in=0; port_hidden_out=0; port_id_len=5; port_id_subtype=if_name;port_lastchange=61ed751e; port_lastupdate=61ed764a;
  31.                                 port_mfs=0; port_protocol=LLDP; power_allocated=0; power_allocated_pair_a=0; power_allocated_pair_b=0; power_class=Class0; power_devicetype=PSE; power_enabled=1; power_paircontrol=0;
  32.                                 power_pairs=SIGNAL; power_powertype=None; power_priority=Unknown; power_requested=0; power_requested_pair_a=0; power_requested_pair_b=0; power_source=Unknown; power_supported=1;
  33.                                 remote_index=2}
  34.     neighbor_info_organizational : @{1=; 2=; 3=}
  35.     port_id                      : 1/1/9
  37. #and for neighbor info
  39.     (Get-ArubaCXLLDPNeighbor 1/1/8 -depth 2).'08:00:09:0d:2d:06,1/1/9'.neighbor_info
  41.     associated_poe_tlv_for_pd    : dot3
  42.     chassis_capability_available : Bridge, Router
  43.     chassis_capability_enabled   : Bridge, Router
  44.     chassis_description          : Aruba ABC123  Virtual.10.09.0002
  45.     chassis_id_len               : 6
  46.     chassis_id_subtype           : link_local_addr
  47.     chassis_index                : 1
  48.     chassis_name                 : switch
  49.     chassis_protocol             : LLDP
  50.     chassis_refcount             : 2
  51.     chassis_ttl                  : 120
  52.     eee_wake_time_fallback       : 0
  53.     eee_wake_time_rx             : 0
  54.     eee_wake_time_rx_echo        : 0
  55.     eee_wake_time_tx             : 0
  56.     eee_wake_time_tx_echo        : 0
  57.     macphy_autoneg_advertised    : Other
  58.     macphy_autoneg_enabled       : 0
  59.     macphy_autoneg_support       : 0
  60.     macphy_mau_type              :
  61.     mgmt_iface_list              : 33554433
  62.     mgmt_iface_oid_list          : 1.3.6.1.2.1.31.1.1.1.1.33554433
  63.     mgmt_ip_list                 : 192.0.2.44
  64.     pd_dot3_ext_tlv_advertised   : False
  65.     pd_dot3_tlv_advertised       : False
  66.     pd_med_tlv_advertised        : False
  67.     port_description             : 1/1/9
  68.     port_hidden_in               : 0
  69.     port_hidden_out              : 0
  70.     port_id_len                  : 5
  71.     port_id_subtype              : if_name
  72.     port_lastchange              : 61ed751e
  73.     port_lastupdate              : 61ed7686
  74.     port_mfs                     : 0
  75.     port_protocol                : LLDP
  76.     power_allocated              : 0
  77.     power_allocated_pair_a       : 0
  78.     power_allocated_pair_b       : 0
  79.     power_class                  : Class0
  80.     power_devicetype             : PSE
  81.     power_enabled                : 1
  82.     power_paircontrol            : 0
  83.     power_pairs                  : SIGNAL
  84.     power_powertype              : None
  85.     power_priority               : Unknown
  86.     power_requested              : 0
  87.     power_requested_pair_a       : 0
  88.     power_requested_pair_b       : 0
  89.     power_source                 : Unknown
  90.     power_supported              : 1
  91.     remote_index                 : 2

Firmware

Tor Get Firmware information on Aruba CX Switch

  2. #Get Firmware info
  4.     Get-ArubaCXFirmware -attribute current_version -Verbose
  6.     current_version   : FL.10.09.0002
  7.     primary_version   : FL.10.09.0002
  8.     secondary_version : FL.10.09.0002
  9.     default_image     : primary
  10.     booted_image      : primary
  12. #Get Firmware Status
  14.     Get-ArubaCXFirmware -status
  16.     date reason status
  17.     ---- ------ ------
  18.     0    none   none

System

for example to get/set ArubaCX System settings

  2. #Get ALL system settings
  4.     Get-ArubaCXSystem
  6.     aaa                                             : @{dot1x_auth_enable=False; dot1x_remote_auth_method=eap-radius; fail_through=False; login_lockout_time=300; 
  7.                                                     mac_auth_address_format=no-delimiter; mac_auth_enable=False; mac_auth_radius_auth_method=chap; 
  8.                                                     portaccess_local_accounting_enable=False; radius_auth=pap; radius_retries=1; radius_timeout=5; 
  9.                                                     radius_tracking_time_interval=300; radius_tracking_user_name=radius-tracking-user; tacacs_auth=pap; 
  10.                                                     tacacs_timeout=5; tacacs_tracking_time_interval=300; tacacs_tracking_user_name=tacacs-tracking-user}
  11.     aaa_accounting_attributes                       : /rest/v10.04/system/aaa_accounting_attributes
  12.     aaa_server_group_prios                          : /rest/v10.04/system/aaa_server_group_prios
  13.     aaa_server_groups                               : /rest/v10.04/system/aaa_server_groups
  14.     acl_object_groups                               : /rest/v10.04/system/acl_object_groups
  15.     acls                                            : /rest/v10.04/system/acls
  16.     admin_password_set                              : True
  17.     [...]
  19. #Get hostname and timezone system settings
  21.     Get-ArubaCXSystem -attribute hostname, timezone
  23.     hostname    timezone
  24.     --------    --------
  25.     switch      UTC
  27. #Set hostname
  29.     Set-ArubaCXSystem -hostname PowerArubaCX-Switch
  31.     [...]
  32.     hostname                                        : PowerArubaCX-Switch
  33.     [...]
  35. #Set timezone
  37.     Set-ArubaCXSystem -timezone Europe/Paris
  39.     [...]
  40.     timezone                                        : Europe/Paris
  41.     [...]
  43. #Set a setting don't have (yet) parameter (usb_disable)
  45.     $system = Get-ArubaCXSystem -selector writable
  46.     $system.usb_disable = $true
  47.     $system | Set-ArubaCXSystem -use_pipeline
  49.     [...]
  50.     usb_disable                                     : True
  51.     [...]

Users

You can get Users (local account) of Aruba CX

  2. #Get ALL local user
  3.     Get-ArubaCXUsers
  5.     admin
  6.     -----
  7.     /rest/v10.09/system/users/admin
  9. #Get info about admin local user
  11.     Get-ArubaCXUsers -user admin
  13.     authorized_keys :
  14.     name            : admin
  15.     origin          : built-in
  16.     password        : AQBapU0TkclkN5abVvBfWakRLdEwQAuF4jP3oqWRlwxj4avqYgAAAFw0UPMjwXH1xvCD00IaJ5YMo+OxvaA853gdPSu4cjkzvYlKIuQvQ52v6YH1wtxbBIU5nht+RMM2thytQZO7PNut4PNFnNwUP22h0Aq16IdEy2Oc2ma0csZ00l+TaGa4o8Ja
  17.     user_group      : @{administrators=/rest/v10.09/system/user_groups/administrators}

VRF

You can create a new VRF Add-ArubaCXVrfs, retrieve its information Get-ArubaCXVrfs, modify its properties Set-ArubaCXVrfs, or delete it Remove-ArubaCXVrfs.

  2. # Create a vrf
  3.     Add-ArubaCXVrfs -name blue
  5.     [...]
  6.     https_server                            :
  7.     [...]
  8.     name                                    : blue
  9.     [...]
  10.     rd                                      :
  11.     [...]
  12.     snmp_enable                             : False
  13.     [...]
  14.     source_interface                        :
  15.     source_ip                               :
  16.     ssh_enable                              :
  17.     [...]
  19. # Get information about a vrf
  20.     Get-ArubaCXvrfs -name blue -attributes name, https_server, rd, ssh_enable, snmp_enable
  22.     https_server :
  23.     name         : blue
  24.     rd           :
  25.     snmp_enable  : False
  26.     ssh_enable   :
  28. # Change settings of a vrf (rd, snmp, ssh, https)
  29.     Get-ArubaCXVrfs blue | Set-ArubaCXVrfs -ssh_enable -https_server -snmp_enable -rd 11:22
  31.     [...]
  32.     https_server                            : @{enable=True}
  33.     [...]
  34.     name                                    : blue
  35.     [...]
  36.     rd                                      : 11:22
  37.     [...]
  38.     snmp_enable                             : True
  39.     [...]
  40.     source_interface                        :
  41.     source_ip                               :
  42.     ssh_enable                              : True
  43.     [...]
  45. # Remove a vrf
  46.     Get-ArubaCXVrfs blue | Remove-ArubaCXVrfs
  48.     Confirm
  49.     Are you sure you want to perform this action?
  50.     Performing the operation "Remove Vrf blue" on target "Vrf".
  51.     [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

VM

You can use PowerArubaCX for help to deploy Aruba CX OVA on VMware ESXi (With a vCenter)
You need to have VMware.PowerCLI and Set-VMKeystrokes from William Lam

You can use the following cmdlet (on this order)

  • Deploy-ArubaCXVm Deploy CPPM OVA with add hard disk
  • Set-ArubaCXVMFirstBootPassword Configure first boot (Password…)
  • Set-ArubaCXVMMgmtOobm Configure OOBM Interface (ip, default-gateway)

MultiConnection

From release 0.4.0, it is possible to connect on same times to multi Aruba CX
You need to use -connection parameter to cmdlet

For example to get system of 2 ArubaCX

  1. # Connect to first ArubaCX
  2.     $cx1 = Connect-ArubaCX 192.0.2.1 -SkipCertificateCheck -DefaultConnection:$false
  4. #DefaultConnection set to false is not mandatory but only don't set the connection info on global variable
  6. # Connect to second ArubaCX
  7.     $cx2 = Connect-ArubaCX 192.0.2.2 -SkipCertificateCheck -DefaultConnection:$false
  9.     # Get System hostname and mgmt  interface for first ArubaCX Switch
  10.     Get-ArubaCXSystem -attributes mgmt_intf, hostname -connection $cx1
  12.     hostname             mgmt_intf
  13.     --------             ---------
  14.     PowerArubaCX-Switch1 @{admin_state=up; default_gateway=10.200.11.254; dns_server_1=10.200.11.254; dns_server_2=0.0.0.0; ip=10.200.11.1; mode=static;
  16. # Get Interface for second ArubaCX Switch
  17.     Get-ArubaCXSystem -attributes mgmt_intf, hostname -connection $cx2
  19.     hostname             mgmt_intf
  20.     --------             ---------
  21.     PowerArubaCX-Switch2 @{admin_state=up; default_gateway=10.200.11.254; dns_server_1=10.200.11.254; dns_server_2=0.0.0.0; ip=10.200.11.2; mode=static;
  23. #Each cmdlet can use -connection parameter

Disconnecting

  1. # Disconnect from the Aruba CX Switch
  2.     Disconnect-ArubaCX

List of available command

  1. Add-ArubaCXEvpnVlans
  2. Add-ArubaCXInterfaces
  3. Add-ArubaCXInterfacesLagInterfaces
  4. Add-ArubaCXInterfacesVlanTrunks
  5. Add-ArubaCXVlans
  6. Add-ArubaCXVrfs
  7. Confirm-ArubaCXInterfaces
  8. Confirm-ArubaCXSystem
  9. Confirm-ArubaCXVlans
  10. Confirm-ArubaCXVrfs
  11. Connect-ArubaCX
  12. Deploy-ArubaCXVm
  13. Disconnect-ArubaCX
  14. Get-ArubaCXFirmware
  15. Get-ArubaCXInterfaces
  16. Get-ArubaCXLLDPNeighbor
  17. Get-ArubaCXSystem
  18. Get-ArubaCXUsers
  19. Get-ArubaCXVlans
  20. Get-ArubaCXVrfs
  21. Invoke-ArubaCXRestMethod
  22. Remove-ArubaCXInterfaces
  23. Remove-ArubaCXInterfacesLagInterfaces
  24. Remove-ArubaCXInterfacesVlanTrunks
  25. Remove-ArubaCXVlans
  26. Remove-ArubaCXVrfs
  27. Set-ArubaCXCipherSSL
  28. Set-ArubaCXInterfaces
  29. Set-ArubaCXSystem
  30. Set-ArubaCXuntrustedSSL
  31. Set-ArubaCXVlans
  32. Set-ArubaCXVMFirstBootPassword
  33. Set-ArubaCXVMMgmtOobm
  34. Set-ArubaCXVrfs
  35. Show-ArubaCXException

Author

Alexis La Goutte

Special Thanks

  • Warren F. for his blog post ‘Building a Powershell module’
  • Erwan Quelin for help about Powershell

License

Copyright 2018-2022 Alexis La Goutte and the community.