Share via


az security security-connector devops

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

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
                                             --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

--authorization-code

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

--auto-discovery

AutoDiscovery states.

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.

--no-wait

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

Accepted values: 0, 1, f, false, n, no, t, true, y, yes
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az security security-connector devops delete

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]
                                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--resource-group]
                                             [--subscription]
                                             [--yes]

Optional Parameters

--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.

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

The security connector name.

--no-wait

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

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>.

--subscription

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

--yes -y

Do not prompt for confirmation.

Default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az security security-connector devops list-available-azuredevopsorgs

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]
                                                                     [--resource-group]
                                                                     [--subscription]

Optional Parameters

--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.

--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>.

--subscription

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

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az security security-connector devops list-available-githubowners

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]
                                                                  [--resource-group]
                                                                  [--subscription]

Optional Parameters

--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.

--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>.

--subscription

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

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az security security-connector devops list-available-gitlabgroups

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]
                                                                  [--resource-group]
                                                                  [--subscription]

Optional Parameters

--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.

--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>.

--subscription

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

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az security security-connector devops show

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]
                                           [--resource-group]
                                           [--subscription]

Optional Parameters

--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.

--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>.

--subscription

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

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az security security-connector devops update

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]
                                             [--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

--authorization-code

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

--auto-discovery

AutoDiscovery states.

Accepted values: Disabled, Enabled, NotApplicable
--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.

--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.

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

The security connector name.

--no-wait

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

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>.

--subscription

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

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az security security-connector devops wait

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]
                                           [--resource-group]
                                           [--subscription]
                                           [--timeout]
                                           [--updated]

Optional Parameters

--created

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

Default value: False
--custom

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

--deleted

Wait until deleted.

Default value: False
--exists

Wait until the resource exists.

Default value: False
--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.

--interval

Polling interval in seconds.

Default value: 30
--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>.

--subscription

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

--timeout

Maximum wait in seconds.

Default value: 3600
--updated

Wait until updated with provisioningState at 'Succeeded'.

Default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.