Merge branch 'MicrosoftDocs:main' into main

Author: ChaseCrum

2017-03-09-profile/docs-ref-autogen/account/management-group.yml

@@ -179,7 +179,7 @@ directCommands:
   - name: --add
     defaultValue: "[]"
     summary: |-
-      Add an object to a list of objects by specifying a path and key value pairs.  Example: --add property.listProperty <key=value, string or JSON string>.
+      Add an object to a list of objects by specifying a path and key value pairs.  Example: `--add property.listProperty <key=value, string or JSON string>`.
   - name: --display-name -d
     summary: |-
       Updates the display name of the management group. If null, no change is made.
@@ -193,11 +193,11 @@ directCommands:
   - name: --remove
     defaultValue: "[]"
     summary: |-
-      Remove a property or an element from a list.  Example: --remove property.list <indexToRemove> OR --remove propertyToRemove.
+      Remove a property or an element from a list.  Example: `--remove property.list <indexToRemove>` OR `--remove propertyToRemove`.
   - name: --set
     defaultValue: "[]"
     summary: |-
-      Update an object by specifying a property path and value to set.  Example: --set property1.property2=<value>.
+      Update an object by specifying a property path and value to set.  Example: `--set property1.property2=<value>`.
 commands:
 - az_account_management-group_check-name-availability
 - az_account_management-group_create

2017-03-09-profile/docs-ref-autogen/account/management-group/hierarchy-settings.yml

@@ -120,7 +120,7 @@ directCommands:
   - name: --add
     defaultValue: "[]"
     summary: |-
-      Add an object to a list of objects by specifying a path and key value pairs.  Example: --add property.listProperty <key=value, string or JSON string>.
+      Add an object to a list of objects by specifying a path and key value pairs.  Example: `--add property.listProperty <key=value, string or JSON string>`.
   - name: --default-management-group -m
     summary: |-
       Set the default Management Group under which new subscriptions get added in this tenant. Default setting is the Root Management Group.
@@ -131,14 +131,14 @@ directCommands:
   - name: --remove
     defaultValue: "[]"
     summary: |-
-      Remove a property or an element from a list.  Example: --remove property.list <indexToRemove> OR --remove propertyToRemove.
+      Remove a property or an element from a list.  Example: `--remove property.list <indexToRemove>` OR `--remove propertyToRemove`.
   - name: --require-authorization-for-group-creation -r
     summary: |-
       Indicate whether RBAC access is required upon group creation under the root Management Group. True means user will require Microsoft.Management/managementGroups/write action on the root Management Group. Default setting is false.
   - name: --set
     defaultValue: "[]"
     summary: |-
-      Update an object by specifying a property path and value to set.  Example: --set property1.property2=<value>.
+      Update an object by specifying a property path and value to set.  Example: `--set property1.property2=<value>`.
 commands:
 - az_account_management-group_hierarchy-settings_create
 - az_account_management-group_hierarchy-settings_delete

2017-03-09-profile/docs-ref-autogen/ad/app.yml

@@ -350,7 +350,7 @@ directCommands:
   - name: --add
     defaultValue: "[]"
     summary: |-
-      Add an object to a list of objects by specifying a path and key value pairs.  Example: --add property.listProperty <key=value, string or JSON string>.
+      Add an object to a list of objects by specifying a path and key value pairs.  Example: `--add property.listProperty <key=value, string or JSON string>`.
   - name: --app-roles
     summary: |-
       The collection of roles assigned to the application. With app role assignments, these roles can be assigned to users, groups, or service principals associated with other applications. Should be JSON file path or in-line JSON string. See examples for details.
@@ -404,14 +404,14 @@ directCommands:
   - name: --remove
     defaultValue: "[]"
     summary: |-
-      Remove a property or an element from a list.  Example: --remove property.list <indexToRemove> OR --remove propertyToRemove.
+      Remove a property or an element from a list.  Example: `--remove property.list <indexToRemove>` OR `--remove propertyToRemove`.
   - name: --required-resource-accesses
     summary: |-
       Specifies the resources that the application needs to access. This property also specifies the set of delegated permissions and application roles that it needs for each of those resources. This configuration of access to the required resources drives the consent experience. Should be JSON file path or in-line JSON string. See examples for details.
   - name: --set
     defaultValue: "[]"
     summary: |-
-      Update an object by specifying a property path and value to set.  Example: --set property1.property2=<value>.
+      Update an object by specifying a property path and value to set.  Example: `--set property1.property2=<value>`.
   - name: --sign-in-audience
     parameterValueGroup: "AzureADMultipleOrgs, AzureADMyOrg, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount"
     summary: |-

2017-03-09-profile/docs-ref-autogen/ad/ds.yml

@@ -179,7 +179,6 @@ directCommands:
                     [--name]
                     [--no-wait]
                     [--resource-group]
-                    [--subscription]
                     [--yes]
   examples:
   - summary: |-
@@ -199,9 +198,6 @@ directCommands:
   - name: --resource-group -g
     summary: |-
       Name of resource group. You can configure the default group using `az configure --defaults group=<name>`.
-  - name: --subscription
-    summary: |-
-      Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
   - name: --yes -y
     defaultValue: "False"
     summary: |-
@@ -238,7 +234,6 @@ directCommands:
     az ad ds show [--ids]
                   [--name]
                   [--resource-group]
-                  [--subscription]
   examples:
   - summary: |-
       Get Domain Service
@@ -253,9 +248,6 @@ directCommands:
   - name: --resource-group -g
     summary: |-
       Name of resource group. You can configure the default group using `az configure --defaults group=<name>`.
-  - name: --subscription
-    summary: |-
-      Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
 - uid: az_ad_ds_update
   name: az ad ds update
   summary: |-
@@ -283,7 +275,6 @@ directCommands:
                     [--resource-group]
                     [--settings]
                     [--sku {Enterprise, Premium, Standard}]
-                    [--subscription]
                     [--sync-kerberos-pwd {Disabled, Enabled}]
                     [--sync-ntlm-pwd {Disabled, Enabled}]
                     [--sync-on-prem-pwd {Disabled, Enabled}]
@@ -386,9 +377,6 @@ directCommands:
     parameterValueGroup: "Enterprise, Premium, Standard"
     summary: |-
       Sku Type.
-  - name: --subscription
-    summary: |-
-      Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
   - name: --sync-kerberos-pwd
     parameterValueGroup: "Disabled, Enabled"
     summary: |-
@@ -425,7 +413,6 @@ directCommands:
                   [--interval]
                   [--name]
                   [--resource-group]
-                  [--subscription]
                   [--timeout]
                   [--updated]
   examples:
@@ -467,9 +454,6 @@ directCommands:
   - name: --resource-group -g
     summary: |-
       Name of resource group. You can configure the default group using `az configure --defaults group=<name>`.
-  - name: --subscription
-    summary: |-
-      Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
   - name: --timeout
     defaultValue: "3600"
     summary: |-

2017-03-09-profile/docs-ref-autogen/ad/sp.yml

@@ -188,19 +188,19 @@ directCommands:
   - name: --add
     defaultValue: "[]"
     summary: |-
-      Add an object to a list of objects by specifying a path and key value pairs.  Example: --add property.listProperty <key=value, string or JSON string>.
+      Add an object to a list of objects by specifying a path and key value pairs.  Example: `--add property.listProperty <key=value, string or JSON string>`.
   - name: --force-string
     defaultValue: "False"
     summary: |-
       When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.
   - name: --remove
     defaultValue: "[]"
     summary: |-
-      Remove a property or an element from a list.  Example: --remove property.list <indexToRemove> OR --remove propertyToRemove.
+      Remove a property or an element from a list.  Example: `--remove property.list <indexToRemove>` OR `--remove propertyToRemove`.
   - name: --set
     defaultValue: "[]"
     summary: |-
-      Update an object by specifying a property path and value to set.  Example: --set property1.property2=<value>.
+      Update an object by specifying a property path and value to set.  Example: `--set property1.property2=<value>`.
 commands:
 - az_ad_sp_create
 - az_ad_sp_create-for-rbac

2017-03-09-profile/docs-ref-autogen/baremetalinstance.yml

@@ -167,7 +167,7 @@ directCommands:
   - name: --add
     defaultValue: "[]"
     summary: |-
-      Add an object to a list of objects by specifying a path and key value pairs.  Example: --add property.listProperty <key=value, string or JSON string>.
+      Add an object to a list of objects by specifying a path and key value pairs.  Example: `--add property.listProperty <key=value, string or JSON string>`.
   - name: --force-string
     defaultValue: "False"
     summary: |-
@@ -185,14 +185,14 @@ directCommands:
   - name: --remove
     defaultValue: "[]"
     summary: |-
-      Remove a property or an element from a list.  Example: --remove property.list <indexToRemove> OR --remove propertyToRemove.
+      Remove a property or an element from a list.  Example: `--remove property.list <indexToRemove>` OR `--remove propertyToRemove`.
   - name: --resource-group -g
     summary: |-
       Name of resource group. You can configure the default group using `az configure --defaults group=<name>`.
   - name: --set
     defaultValue: "[]"
     summary: |-
-      Update an object by specifying a property path and value to set.  Example: --set property1.property2=<value>.
+      Update an object by specifying a property path and value to set.  Example: `--set property1.property2=<value>`.
   - name: --subscription
     summary: |-
       Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.

2017-03-09-profile/docs-ref-autogen/connection.yml

@@ -116,7 +116,7 @@ directCommands:
     List client types and auth types supported by local connections.
   status: GA
   sourceType: Core
-  syntax: az connection list-support-types [--target-type {appconfig, confluent-cloud, cosmos-cassandra, cosmos-gremlin, cosmos-mongo, cosmos-sql, cosmos-table, eventhub, keyvault, mysql, mysql-flexible, postgres, postgres-flexible, redis, redis-enterprise, servicebus, signalr, sql, storage-blob, storage-file, storage-queue, storage-table, webpubsub}]
+  syntax: az connection list-support-types [--target-type {app-insights, appconfig, confluent-cloud, cosmos-cassandra, cosmos-gremlin, cosmos-mongo, cosmos-sql, cosmos-table, eventhub, keyvault, mysql, mysql-flexible, postgres, postgres-flexible, redis, redis-enterprise, servicebus, signalr, sql, storage-blob, storage-file, storage-queue, storage-table, webpubsub}]
   examples:
   - summary: |-
       List all supported target resource types and auth types
@@ -126,7 +126,7 @@ directCommands:
     syntax: az connection list-support-types --target-type storage-blob -o table
   optionalParameters:
   - name: --target-type -t
-    parameterValueGroup: "appconfig, confluent-cloud, cosmos-cassandra, cosmos-gremlin, cosmos-mongo, cosmos-sql, cosmos-table, eventhub, keyvault, mysql, mysql-flexible, postgres, postgres-flexible, redis, redis-enterprise, servicebus, signalr, sql, storage-blob, storage-file, storage-queue, storage-table, webpubsub"
+    parameterValueGroup: "app-insights, appconfig, confluent-cloud, cosmos-cassandra, cosmos-gremlin, cosmos-mongo, cosmos-sql, cosmos-table, eventhub, keyvault, mysql, mysql-flexible, postgres, postgres-flexible, redis, redis-enterprise, servicebus, signalr, sql, storage-blob, storage-file, storage-queue, storage-table, webpubsub"
     summary: |-
       The target resource type.
 - uid: az_connection_show
@@ -261,6 +261,7 @@ directCommands:
       Wait until updated with provisioningState at 'Succeeded'.
 commands:
 - az_connection_create
+- az_connection_create_app-insights
 - az_connection_create_appconfig
 - az_connection_create_confluent-cloud
 - az_connection_create_cosmos-cassandra
@@ -293,6 +294,7 @@ commands:
 - az_connection_list
 - az_connection_list-support-types
 - az_connection_preview-configuration
+- az_connection_preview-configuration_app-insights
 - az_connection_preview-configuration_appconfig
 - az_connection_preview-configuration_confluent-cloud
 - az_connection_preview-configuration_cosmos-cassandra
@@ -318,6 +320,7 @@ commands:
 - az_connection_preview-configuration_webpubsub
 - az_connection_show
 - az_connection_update
+- az_connection_update_app-insights
 - az_connection_update_appconfig
 - az_connection_update_confluent-cloud
 - az_connection_update_cosmos-cassandra

2017-03-09-profile/docs-ref-autogen/connection/create.yml

@@ -10,6 +10,70 @@ summary: |-
 status: GA
 sourceType: Core and Extension
 directCommands:
+- uid: az_connection_create_app-insights
+  name: az connection create app-insights
+  summary: |-
+    Create a Service Connector local connection to app-insights.
+  status: GA
+  sourceType: Core
+  syntax: >-
+    az connection create app-insights --resource-group
+                                      [--app-insights]
+                                      [--client-type {dotnet, dotnet-internal, go, java, nodejs, none, python}]
+                                      [--connection]
+                                      [--customized-keys]
+                                      [--location]
+                                      [--no-wait]
+                                      [--secret]
+                                      [--target-id]
+                                      [--target-resource-group]
+  examples:
+  - summary: |-
+      Create a connection from local to app-insights interactively
+    syntax: az connection create app-insights -g resourceGroup
+  - summary: |-
+      Create a connection from local to app-insights with resource name
+    syntax: az connection create app-insights -g resourceGroup --tg AppInsightsRG --app-insights MyAppInsights --secret
+  - summary: |-
+      Create a connection from local to app-insights with resource id
+    syntax: az connection create app-insights -g resourceGroup --target-id /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/microsoft.insights/components/{appinsights} --secret
+  requiredParameters:
+  - isRequired: true
+    name: --resource-group -g
+    summary: |-
+      Name of resource group. You can configure the default group using `az configure --defaults group=<name>`.
+  optionalParameters:
+  - name: --app-insights
+    summary: |-
+      Name of the app insights. Required if '--target-id' is not specified.
+  - name: --client-type
+    parameterValueGroup: "dotnet, dotnet-internal, go, java, nodejs, none, python"
+    summary: |-
+      The client type used on the connection.
+  - name: --connection
+    summary: |-
+      Name of the connection.
+  - name: --customized-keys
+    summary: |-
+      The customized keys used to change default configuration names. Key is the original name, value is the customized name.
+  - name: --location -l
+    summary: |-
+      Location. Values from: `az account list-locations`. You can configure the default location using `az configure --defaults location=<location>`.
+  - name: --no-wait
+    defaultValue: "False"
+    summary: |-
+      Do not wait for the long-running operation to finish.
+  - name: --secret
+    summary: |-
+      The secret auth info.
+    description: |-
+      Usage: --secret.
+  - name: --target-id
+    summary: |-
+      The resource id of target service. Required if ['--target-resource-group', '--app-insights'] are not specified.
+  - name: --target-resource-group --tg
+    summary: |-
+      The resource group which contains the app insights. Required if '--target-id' is not specified.
 - uid: az_connection_create_appconfig
   name: az connection create appconfig
   summary: |-
@@ -2084,8 +2148,10 @@ directCommands:
                                        [--location]
                                        [--no-wait]
                                        [--secret]
+                                       [--service-principal]
                                        [--target-id]
                                        [--target-resource-group]
+                                       [--user-account]
   examples:
   - summary: |-
       Create a connection from local to storage-table interactively
@@ -2127,12 +2193,28 @@ directCommands:
       The secret auth info.
     description: |-
       Usage: --secret.
+  - name: --service-principal
+    summary: |-
+      The service principal auth info.
+    description: |-
+      Usage: --service-principal client-id=XX secret=XX
+
+      client-id      : Required. Client id of the service principal.
+      object-id      : Optional. Object id of the service principal (Enterprise Application).
+      secret         : Required. Secret of the service principal.
   - name: --target-id
     summary: |-
       The resource id of target service. Required if ['--target-resource-group', '--account'] are not specified.
   - name: --target-resource-group --tg
     summary: |-
       The resource group which contains the storage account. Required if '--target-id' is not specified.
+  - name: --user-account
+    summary: |-
+      The user account auth info.
+    description: |-
+      Usage: --user-account object-id=XX
+
+      object-id              : Optional. Object id of current login user. It will be set automatically if not provided.
 - uid: az_connection_create_webpubsub
   name: az connection create webpubsub
   summary: |-
@@ -2216,6 +2298,7 @@ directCommands:
     summary: |-
       Name of the webpubsub service. Required if '--target-id' is not specified.
 commands:
+- az_connection_create_app-insights
 - az_connection_create_appconfig
 - az_connection_create_confluent-cloud
 - az_connection_create_cosmos-cassandra