Merge pull request #10 from Azure/master

going to live

azure-cli-conceptual/TOC.md

@@ -1 +1,2 @@
-# [Index](index.md)
+# [Index](index.md)
+## [Old and new CLIs](old-and-new-clis.md)

azure-cli-conceptual/index.md

@@ -1 +1,99 @@
-# Welcome to azure-cli-conceptual!
+---
+title: Get started with Azure 2.0 CLI Preview 
+description: Get started with Azure 2.0 CLI Preview on Linux, Mac, or Windows.
+keywords: Azure CLI 2.0, Linux, Mac, Windows, OS X, Ubuntu, Debian, CentOS, RHEL, SUSE, CoreOS, Docker, Windows, Python, PIP
+author: allclark
+manager: douge
+ms.date: 11/14/2016
+ms.topic: article
+ms.prod: azure
+ms.technology: azure
+ms.assetid: 85c418a8-6177-4833-bb8d-ff4ce2233c1a
+---
+
+# Get started with Azure 2.0 CLI Preview
+
+1. [Install Azure CLI 2.0 Preview](https://github.com/Azure/azure-cli/blob/master/doc/preview_install_guide.md)
+on whatever platform you use.
+
+2. Run `az` with no arguments to verify the installation. You should get a page like this:
+
+    ```
+    Welcome to the cool new Azure CLI!
+
+    Here are the base commands:
+
+        account  : Manages stored and default subscriptions.
+        acs      : Manage Azure container services.
+        ad       : Synchronize on-premises directories and manage Azure Active Directory (AAD)
+                resources.
+        cloud    : Manage the Azure clouds registered.
+        component: Manages and updates Azure CLI components.
+        configure: Interactive experience for setting up the Azure CLI.
+        context  : Manage contexts.
+        feedback : Loving or hating the CLI?  Let us know!
+        login    : Log in to access Azure subscriptions.
+        logout   : Log out to remove accesses to Azure subscriptions.
+        network  : Manages Network resources.
+        provider : Manage resource providers.
+        resource : Generic commands to manage Azure resources.
+        role     : Use role assignments to manage access to your Azure resources.
+        storage  : Durable, highly available, and massively scalable cloud storage.
+        tag      : Manage resource tags.
+        vm       : Provision Linux and Windows virtual machines in minutes.
+        vmss     : Create highly available, auto-scalable Linux or Windows virtual machines.
+    ```
+
+3. Run the login command.
+
+    ```azurecli
+    az login
+    ```
+    
+    You'll be prompted to open https://aka.ms/devicelogin and enter a code.
+
+4. Use a web browser to open the page https://aka.ms/devicelogin and enter the code to authenticate.
+
+    You'll be prompted to log in using your credentials.
+    
+5. Login in.
+
+    Now you can run any command that accesses your account.
+
+Here are some other things to try:
+
+- Create a resource group
+
+    ```azurecli
+    az resource group create -l westus -n MyRG
+    ```
+
+- Create a VM
+
+    ```azurecli
+    az vm create -g MyRG -n MyVM --admin-username admin --admin-password Password@1234
+    ```
+
+- Look at more [samples](https://github.com/Azure/azure-cli-samples).
+
+- Get help.
+
+    ```azurecli
+    az [command-group [command]] -h
+    ```
+
+    For example, to get see what commands and subgroups are available for VMs, use
+
+    ```azurecli
+    az vm -h
+    ```
+
+    To get help with the command to create a VM, use
+
+    ```azurecli
+    az vm create -h
+    ```
+
+- Read the [API reference docs](https://docs.microsoft.com/cli/azure).
+
+- Send us your feedback using `az feedback`.

azure-cli-conceptual/old-and-new-clis.md

@@ -0,0 +1,52 @@
+---
+title: Old and new Azure CLIs
+description: There is a new CLI for Azure - Azure CLI 2.0 Preview. How do the old and new CLIs compare?
+keywords: Azure CLI 2.0, Linux, Mac, Windows, OS X, Ubuntu, Debian, CentOS, RHEL, SUSE, CoreOS, Docker, Windows, Python, PIP
+author: allclark
+manager: douge
+ms.date: 11/14/2016
+ms.topic: article
+ms.prod: azure
+ms.technology: azure
+ms.assetid: 80ae9f6c-adb7-483c-bfb4-fbb958e075ba
+---
+
+# Old and new Azure CLIs
+
+With the continued growth of Azure, we’ve seen a lot of customers using our command-line tools,
+particularly the Windows PowerShell tools and our Azure command-line interface (CLI).
+We’ve received a lot of feedback on the great productivity provided by command-line tools,
+but have also heard, especially from customers working with Linux,
+about our current CLI and its poor integration with popular Linux command-line tools
+and difficulties with installing and maintaining the Node environment (on which it was based).
+
+Based on this feedback - along with the growth in the Azure Resource Manager-based configuration model -
+we improved the CLI experience and now provide a great experience for Azure.
+We’re calling it the Azure CLI 2.0 Preview, now available as a beta on [GitHub](http://github.com/azure/azure-cli).
+
+As we set out to develop our next generation of command-line tools, we quickly settled on some guiding principles:
+- **It must be natural and easy to install:**
+  Regardless of your platform, our CLI should be installed from where you expect it,
+  be it from “brew install azure-cli” on a MacBook, or from “apt-get install azure-cli” for BASH on Windows (coming soon).
+- **It must be consistent with POSIX tools:**
+  Success with command-line tools is the result of the ease and predictability
+  that comes with the implementation of well-understood standards.
+- **It must be part of the open source ecosystem:**
+  The value of open source comes from the community and the amazing features and integrations they develop,
+  from DevOps (Chef, Ansible) solutions to query languages (JMESPath).
+- **It must be evergreen and current with Azure:**
+  In an age of continuous delivery, it's not enough to simply deploy a service.
+  We must have up-to-date tools that let our customers immediately take advantage of that service. 
+
+As we applied these principles, we realized that the scope of improvements went beyond a few breaking changes,
+and when combined with the feedback we’ve received about our old CLI,
+it made sense to start from the ground up.
+This choice allowed us to focus exclusively on the resource manager [deployment model](https://docs.microsoft.com/azure/resource-manager-deployment-model).
+
+So Azure CLI 2.0 Preview (az) is applicable when you use the resource manager deployment model.
+When you use the service management deployment model, you need to contiunue to use Azure CLI (azure).
+You can, of course, continue to use Azure CLI (azure) with the resource manager deployment model as you do today,
+but we recommend you plan to switch to Azure CLI 2.0 Preview when you're able to do that.
+
+[Get started](index.md) with Azure CLI 2.0 Preview now.
+