az security security-connector devops

Preview

Command group 'az security security-connector' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

DevOps configuration and operations.

Commands

Name	Description	Type	Status
az security security-connector devops azuredevopsorg	AzureDevOps Organizations.	Core	Preview
az security security-connector devops azuredevopsorg create	Create monitored Azure DevOps organization details.	Core	Preview
az security security-connector devops azuredevopsorg list	List Azure DevOps organizations onboarded to the connector.	Core	Preview
az security security-connector devops azuredevopsorg project	Azure DevOps projects.	Core	Preview
az security security-connector devops azuredevopsorg project create	Create a monitored Azure DevOps project resource.	Core	Preview
az security security-connector devops azuredevopsorg project list	List Azure DevOps projects onboarded to the connector.	Core	Preview
az security security-connector devops azuredevopsorg project repo	Azure DevOps repositories.	Core	Preview
az security security-connector devops azuredevopsorg project repo create	Create a monitored Azure DevOps repository resource.	Core	Preview
az security security-connector devops azuredevopsorg project repo list	List Azure DevOps repositories onboarded to the connector.	Core	Preview
az security security-connector devops azuredevopsorg project repo show	Get a monitored Azure DevOps repository resource.	Core	Preview
az security security-connector devops azuredevopsorg project repo update	Update a monitored Azure DevOps repository resource.	Core	Preview
az security security-connector devops azuredevopsorg project repo wait	Place the CLI in a waiting state until a condition is met.	Core	Preview
az security security-connector devops azuredevopsorg project show	Get a monitored Azure DevOps project resource.	Core	Preview
az security security-connector devops azuredevopsorg project update	Update a monitored Azure DevOps project resource.	Core	Preview
az security security-connector devops azuredevopsorg project wait	Place the CLI in a waiting state until a condition is met.	Core	Preview
az security security-connector devops azuredevopsorg show	Get a monitored Azure DevOps organization resource.	Core	Preview
az security security-connector devops azuredevopsorg update	Update monitored Azure DevOps organization details.	Core	Preview
az security security-connector devops azuredevopsorg wait	Place the CLI in a waiting state until a condition is met.	Core	Preview
az security security-connector devops create	Create a DevOps Configuration.	Core	Experimental
az security security-connector devops delete	Delete a DevOps Connector.	Core	Preview
az security security-connector devops githubowner	GitHub Owners.	Core	Preview
az security security-connector devops githubowner list	List a list of GitHub owners onboarded to the connector.	Core	Preview
az security security-connector devops githubowner repo	GitHub repositories.	Core	Preview
az security security-connector devops githubowner repo list	List GitHub repositories onboarded to the connector.	Core	Preview
az security security-connector devops githubowner repo show	Get a monitored GitHub repository.	Core	Preview
az security security-connector devops githubowner show	Get a monitored GitHub owner.	Core	Preview
az security security-connector devops gitlabgroup	GitLab Groups.	Core	Preview
az security security-connector devops gitlabgroup list	List GitLab groups onboarded to the connector.	Core	Preview
az security security-connector devops gitlabgroup list-subgroups	Gets nested subgroups of given GitLab Group which are onboarded to the connector.	Core	Preview
az security security-connector devops gitlabgroup project	GitLab Projects (Repositories).	Core	Preview
az security security-connector devops gitlabgroup project list	List GitLab projects that are directly owned by given group and onboarded to the connector.	Core	Preview
az security security-connector devops gitlabgroup project show	Get a monitored GitLab Project resource for a given fully-qualified group name and project name.	Core	Preview
az security security-connector devops gitlabgroup show	Get a monitored GitLab Group resource for a given fully-qualified name.	Core	Preview
az security security-connector devops list-available-azuredevopsorgs	Returns a list of all Azure DevOps organizations accessible by the user token consumed by the connector. Returns 401 if connector was created by different user or identity.	Core	Preview
az security security-connector devops list-available-githubowners	Returns a list of all GitHub owners accessible by the user token consumed by the connector. Returns 401 if connector was created by different user or identity.	Core	Preview
az security security-connector devops list-available-gitlabgroups	Returns a list of all GitLab groups accessible by the user token consumed by the connector. Returns 401 if connector was created by different user or identity.	Core	Preview
az security security-connector devops show	Get a DevOps Configuration.	Core	Preview
az security security-connector devops update	Update a DevOps Configuration.	Core	Experimental
az security security-connector devops wait	Place the CLI in a waiting state until a condition is met.	Core	Preview

az security security-connector devops create

Edit

Experimental

This command is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Create a DevOps Configuration.

az security security-connector devops create --name --security-connector-name
                                             --resource-group
                                             [--authorization-code]
                                             [--auto-discovery {Disabled, Enabled, NotApplicable}]
                                             [--inventory-list]
                                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Examples

Configure access to DevOps SCM provider to onboard all existing and future organizations

az security security-connectors devops create --name myConnector --resource-group myResourceGroup --auto-discovery Enabled --authorization-code MyAccessToken

Configure access to DevOps SCM provider to onboard all existing organizations

az security security-connectors devops create --name myConnector --resource-group myResourceGroup --auto-discovery Disable --authorization-code $MY_ENVIRONMENT_VARIABLE_WITH_OAUTHTOKEN

Configure access to DevOps SCM provider to onboard specific organizations

az security security-connectors devops create --name myConnector --resource-group myResourceGroup --auto-discovery Disable --top-level-inventory-list org1,org2 --authorization-code myOAuthToken

Required Parameters

--name --security-connector-name -n

The security connector name.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--authorization-code

Sets one-time OAuth code to exchange for refresh and access tokens.

Property	Value
Parameter group:	Authorization Arguments

--auto-discovery

AutoDiscovery states.

Property	Value
Parameter group:	Properties Arguments
Accepted values:	Disabled, Enabled, NotApplicable

--inventory-list

List of top-level inventory to select when AutoDiscovery is disabled. This field is ignored when AutoDiscovery is enabled. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

Property	Value
Parameter group:	Properties Arguments

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Accepted values:	0, 1, f, false, n, no, t, true, y, yes

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az security security-connector devops delete

Edit

Preview

Command group 'az security security-connector devops' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Delete a DevOps Connector.

az security security-connector devops delete [--ids]
                                             [--name --security-connector-name]
                                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--resource-group]
                                             [--subscription]
                                             [--yes]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--name --security-connector-name -n

The security connector name.

Property	Value
Parameter group:	Resource Id Arguments

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Accepted values:	0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

--yes -y

Do not prompt for confirmation.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az security security-connector devops list-available-azuredevopsorgs

Edit

Preview

Command group 'az security security-connector devops' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Returns a list of all Azure DevOps organizations accessible by the user token consumed by the connector. Returns 401 if connector was created by different user or identity.

az security security-connector devops list-available-azuredevopsorgs [--ids]
                                                                     [--name --security-connector-name]
                                                                     [--resource-group]
                                                                     [--subscription]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Property	Value
Parameter group:	Resource Id Arguments

--name --security-connector-name -n

The security connector name.

Property	Value
Parameter group:	Resource Id Arguments

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az security security-connector devops list-available-githubowners

Edit

Preview

Command group 'az security security-connector devops' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Returns a list of all GitHub owners accessible by the user token consumed by the connector. Returns 401 if connector was created by different user or identity.

az security security-connector devops list-available-githubowners [--ids]
                                                                  [--name --security-connector-name]
                                                                  [--resource-group]
                                                                  [--subscription]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Property	Value
Parameter group:	Resource Id Arguments

--name --security-connector-name -n

The security connector name.

Property	Value
Parameter group:	Resource Id Arguments

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az security security-connector devops list-available-gitlabgroups

Edit

Preview

Command group 'az security security-connector devops' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Returns a list of all GitLab groups accessible by the user token consumed by the connector. Returns 401 if connector was created by different user or identity.

az security security-connector devops list-available-gitlabgroups [--ids]
                                                                  [--name --security-connector-name]
                                                                  [--resource-group]
                                                                  [--subscription]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Property	Value
Parameter group:	Resource Id Arguments

--name --security-connector-name -n

The security connector name.

Property	Value
Parameter group:	Resource Id Arguments

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az security security-connector devops show

Edit

Preview

Command group 'az security security-connector devops' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Get a DevOps Configuration.

az security security-connector devops show [--ids]
                                           [--name --security-connector-name]
                                           [--resource-group]
                                           [--subscription]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Property	Value
Parameter group:	Resource Id Arguments

--name --security-connector-name -n

The security connector name.

Property	Value
Parameter group:	Resource Id Arguments

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az security security-connector devops update

Edit

Experimental

This command is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Update a DevOps Configuration.

az security security-connector devops update [--authorization-code]
                                             [--auto-discovery {Disabled, Enabled, NotApplicable}]
                                             [--ids]
                                             [--inventory-list]
                                             [--name --security-connector-name]
                                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--resource-group]
                                             [--subscription]

Examples

Disable AutoDiscovery

az security security-connectors devops update --name myConnector --resource-group myResourceGroup --auto-discovery Disabled

Disable AutoDiscovery and select only specific organizations

az security security-connectors devops update --name myConnector --resource-group myResourceGroup --auto-discovery Disabled --top-level-inventory-list org1,org2

Enable AutoDiscovery

az security security-connectors devops update --name myConnector --resource-group myResourceGroup --auto-discovery Enabled

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--authorization-code

Sets one-time OAuth code to exchange for refresh and access tokens. Optional if connector was created by the same identity.

Property	Value
Parameter group:	Authorization Arguments

--auto-discovery

AutoDiscovery states.

Property	Value
Parameter group:	Properties Arguments
Accepted values:	Disabled, Enabled, NotApplicable

--ids

Property	Value
Parameter group:	Resource Id Arguments

--inventory-list

List of top-level inventory to select when AutoDiscovery is disabled. This field is ignored when AutoDiscovery is enabled. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

Property	Value
Parameter group:	Properties Arguments

--name --security-connector-name -n

The security connector name.

Property	Value
Parameter group:	Resource Id Arguments

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Accepted values:	0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az security security-connector devops wait

Edit

Preview

Command group 'az security security-connector devops' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Place the CLI in a waiting state until a condition is met.

az security security-connector devops wait [--created]
                                           [--custom]
                                           [--deleted]
                                           [--exists]
                                           [--ids]
                                           [--interval]
                                           [--name --security-connector-name]
                                           [--resource-group]
                                           [--subscription]
                                           [--timeout]
                                           [--updated]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

Wait until created with 'provisioningState' at 'Succeeded'.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Property	Value
Parameter group:	Wait Condition Arguments

--deleted

Wait until deleted.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--exists

Wait until the resource exists.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--ids

Property	Value
Parameter group:	Resource Id Arguments

--interval

Polling interval in seconds.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	30

--name --security-connector-name -n

The security connector name.

Property	Value
Parameter group:	Resource Id Arguments

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

--timeout

Maximum wait in seconds.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	3600

--updated

Wait until updated with provisioningState at 'Succeeded'.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

Share via

az security security-connector devops

Commands

az security security-connector devops create

Examples

Required Parameters

Optional Parameters

az security security-connector devops delete

Optional Parameters

az security security-connector devops list-available-azuredevopsorgs

Optional Parameters

az security security-connector devops list-available-githubowners

Optional Parameters

az security security-connector devops list-available-gitlabgroups

Optional Parameters

az security security-connector devops show

Optional Parameters

az security security-connector devops update

Examples

Optional Parameters

az security security-connector devops wait

Optional Parameters

Feedback