sagcc create landscape environments

Edit online

Creates a new environment that you want to use to manage a collection of installations.

Syntax

  • Command Central syntax:
    • To specify the data for the new environment on the command line: 
      sagcc create landscape environments  alias=env_alias [name=name]     
[description=description]  [options]
    • To specify the data for the new environment in an input data file: 
      sagcc create landscape environments       
{--input | -i} filename{.xml|.json}  [options]
          
 options:         
[{--debug | -d}]         
[{--error | -r} file]         
[{--log | -l} file]         
[{--media-type | -m} content-type]         
[{--password | -p} password]         
[{--quiet | -q}]         
[{--server | -s} url]         
[{--username | -u} user_name]
  • Not applicable to Platform Manager.

Arguments and Options

Argument or Option Description
alias=env_alias Required. Specifies the alias name you want to assign to the new environment. The name must be unique among all environments that Command Central manages.

Valid characters are ASCII characters, numbers, hyphen (-), underscore (_), and period (.). Spaces are not allowed.

[name=name] Optional. Specifies the display name you want to assign to the environment. If you use a value that includes spaces, place quotes around the value, for example: 
name="Dev Environment"

If you do not specify a display name, the command uses the value you supply for the environment alias name.

[description=description] Optional. Specifies a description for the new environment. If you use a value that includes spaces, place quotes around the value, for example: 
description="A description with spaces"

                              [{--input | -i}
                              
                                 filename{.xml|.json}]
                          
Optional. Identifies an input file that contains the data for the new environment. For more information, see input.
Tip: To determine how to specify the data in the input file, use sagcc get landscape environments to retrieve data for an existing environment. For example, if you want to use an XML input file, use sagcc get landscape environments with the --format xml option to retrieve the data in XML format.
[options] Optional. Refer to the command syntax for a list of the options the command supports. For a description of the options, see Common Options.

Usage Notes

Example When Executing on Command Central

To create a new environment with the display name “Development1”, the alias name “dev1”, and a description “Environment to test latest release”: 

sagcc create landscape environments name=Development1 alias=dev1        
description="Environment to test latest release" --password secret

Because the {--server | -s} and {--username | -u} options are not specified, the command uses the default server and user name. For more information, see server and username. The command specifies “secret” for the user’s password