anchor.diff:      Directory docs](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-certificate-credentials)
       for more information.
   
  -### Required:
  -
  -<%= partial "partials/builder/azure/arm/Config-required" %>
  -
  -#### VHD or Managed Image
  +<%= partial "partials/builder/azure/common/client/_Config" %>
  +
  +## Configuration Reference
  +
  +The following configuration options are available for building Azure images. In
  +addition to the options listed here, a [communicator](/docs/templates/communicator.html) can be configured for this
  +builder.
  +
   
   The Azure builder can create either a VHD, or a managed image. If you are
   creating a VHD, you **must** start with a VHD. Likewise, if you want to create
  -a managed image you **must** start with a managed image. When creating a VHD
  -the following options are required.
  +a managed image you **must** start with a managed image. Images can be obtained from
  +the Azure Marketplace or from within a users' subscription - see [Using Custom Images](#using-custom-images)
  +
  +### Using Azure Marketplace Images
  +
  +<%= partial "partials/builder/azure/arm/Config-required" %>
  +
  +### Using Custom Images
  +
  +-   `image_url` (string) - Specify a custom VHD to use. If this value is set, do not set image_publisher, image_offer, image_sku, or image_version.
  +
  +-   `custom_managed_image_resource_group_name` (string) - Specify the source managed image's resource group used to use. If this value is set, do not set image_publisher, image_offer, image_sku, or image_version. If this value is set, the value custom_managed_image_name must also be set. See documentation to learn more about managed images.
  +
  +-   `custom_managed_image_name` (string) - Specify the source managed image's name to use. If this value is set, do not set image_publisher, image_offer, image_sku, or image_version. If this value is set, the value custom_managed_image_resource_group_name must also be set. See documentation to learn more about managed images.
  +
  +
  +When creating a VHD the following options are required:
   
   -   `capture_container_name` (string) - Destination container name. Essentially
       the "directory" where your VHD will be organized in Azure. The captured
  
positive.code: -   `storage_account` (string) - Storage account under which the final artifact
      will be stored.
  
  When creating a managed image the following options are required.
  
  -   `managed_image_name` (string) - Specify the managed image name where the
      result of the Packer build will be saved. The image name must not exist
  
negative.code: The documentation below references command output from the [Azure
  CLI](https://azure.microsoft.com/en-us/documentation/articles/xplat-cli-install/).
  
  ## Authentication:
  There are three options for Authenticationg to Azure, two of which require certain
  configuration options in order to properly build an Azure Arm Image.
  
  ### Managed Identity
  
  If you're running packer on an Azure VM with a [managed identity](/docs/builders/azure.html#azure-managed-identity)
  you don't need to specify any additional configuration options. As Packer will attempt to use the Managed Identity
  and subscription of the VM that Packer is running on.
  
  ### Interactive User Authentication
  To use interactive user authentication, you should specify `subscription_id` only.
  Packer will use cached credentials or redirect you to a website to log in.
  
  ### Service Principal
  To use a [service principal](/docs/builders/azure.html#azure-active-directory-service-principal)
  you should specify `subscription_id`, `client_id` and one of `client_secret`,
  `client_cert_path` or `client_jwt`.
  
  