show object-group

Syntax

show object-group [{ip|ipv6} address | port] [<OBJECT-GROUP-NAME>] [commands] [configuration]

Description

Shows information about your defined object groups. When show object-group is entered without parameters, information for all object groups is shown. The parameters filter the list of object groups for which information is shown.

Command context

Operator (>) or Manager (#)

Parameters

[{ip|ipv6} address | port]

Specifies the object group type, either address for an IP address, or port.

<OBJECT-GROUP-NAME>

Specifies the object group name.

[commands]

Specifies that the object group definition is to be shown as the commands and parameters used to create it rather than in tabular form.

[configuration]

Specifies that the user-configured object groups be shown as configured. The output of the command with this parameter may not be the same as what is active on the switch due to a misconfigured object group. See Examples in this topic.

[vsx-peer]

Shows the output from the VSX peer switch. If the switches do not have the VSX configuration or the ISL is down, the output from the VSX peer switch is not displayed. This parameter is available on switches that support VSX.

Authority

Operators or Administrators or local user group members with execution rights for this command. Operators can execute this command from the operator context (>) only.

Examples

Showing configured object groups:

switch# show object-group
Type       Name
  Sequence L4 Port(s)/IP Address
-------------------------------------------------------------------------------
IPv4       my_address_group
        10 192.168.0.1
        20 192.168.0.3
Port       my_port_group
        10 eq 80
        20 gt 65525
switch# 		
switch# show object-group commands
object-group ip address my_address_group
    10 192.168.0.1
    20 192.168.0.3
object-group port my_port_group
    10 eq 80
    20 gt 65525

Showing a misconfigured object group:

switch# show object-group
Type       Name
  Sequence L4 Port(s)/IP Address
-------------------------------------------------------------------------------
! object-group ip address My_ip_object_group user configuration does not match
! the active hardware configuration. Run 'object-group ip address NAME reset'
! to reset the object group to match the active hardware configuration.
IPv4       my_address_group
switch# 
switch# show object-group configuration
Type       Name
  Sequence L4 Port(s)/IP Address
-------------------------------------------------------------------------------
! object-group ip address My_ip_object_group user configuration does not match
! the active hardware configuration. Run 'object-group ip address NAME reset'
! to reset the object group to match the active hardware configuration.
IPv4       my_address_group
        10 192.168.0.1
        20 192.168.0.3
switch#	
switch# show object-group commands
! object-group ip address My_ip_object_group user configuration does not match
! the active hardware configuration. Run 'object-group ip address NAME reset'
! to reset the object group to match the active hardware configuration.
switch#
switch# show object-group commands configuration
! object-group ip address My_ip_object_group user configuration does not match
! the active hardware configuration. Run 'object-group ip address NAME reset'
! to reset the object group to match the active hardware configuration.
object-group ip address my_address_group
    10 192.168.0.1
    20 192.168.0.3

Resetting a misconfigured object group:

switch(config)# object-group all reset
switch(config)# exit
switch# show object-group
Type       Name
  Sequence L4 Port(s)/IP Address
-------------------------------------------------------------------------------
IPv4       my_address_group
switch#
switch# show object-group configuration
Type       Name
  Sequence L4 Port(s)/IP Address
-------------------------------------------------------------------------------
IPv4       my_address_group