scope
To “scope into” (enter) an existing managed object, use the relevant scope command in the appropriate command mode.
scope object_type name [ parameters]
Syntax Description
object_type |
The type of object to be entered. Examples include local user account and organization. |
name |
The name of the specific object to be entered. |
parameters |
(Optional) Any additional properties or parameters needed to identify the object. With this command, the name is generally sufficient to identify an object. Refer to the description of the create command for the specific object type for more information. |
Command Modes
Depends on the type of object being scoped into; refer to the description of the create command for the specific object type for more information.
Command History
Refer to the description of the create command for the specific object type for history information. |
Usage Guidelines
Objects are abstract representations of physical components or logical entities that can be managed. For example, the chassis, security modules, network modules, ports, and processors are physical components represented as managed objects, while licenses, user roles, and platform policies are logical entities represented as managed objects.
FXOS provides four general commands for managing objects: create , delete , enter , and scope . For example, you can create a local user account, you can delete a local user account, and you can enter a local user account to assign or change properties for that account; you also can “scope into” the local user account to assign or change properties.
Generally, the keywords and options available to each of these object-management commands are the same, so we detail only the create version of the various object commands. In other words, for information about the delete command for a particular object, refer to the description of the create command for that object. For example, refer to create local-user for information related to scoping into an existing local user account.
Examples
This example shows how to enter security mode, scope into a local user account and display account details:
firepower # scope security
firepower /security # scope local-user test_user
firepower /security/local-user # show detail
Local User test_user:
First Name: test
Last Name: user
Email: test_user@testuser.com
Phone:
Expiration: Never
Password: ****
User lock status: Not Locked
Account status: Active
User Roles:
Name: admin
Name: read-only
User SSH public key:
firepower /security/local-user #