diff --git a/src/ResourceManager/ApiManagement/Commands.ApiManagement.ServiceManagement/Microsoft.Azure.Commands.ApiManagement.ServiceManagement.dll-help.Help.pshproj b/src/ResourceManager/ApiManagement/Commands.ApiManagement.ServiceManagement/Microsoft.Azure.Commands.ApiManagement.ServiceManagement.dll-help.Help.pshproj
index fb5c384d187e..0c7eeb147469 100644
--- a/src/ResourceManager/ApiManagement/Commands.ApiManagement.ServiceManagement/Microsoft.Azure.Commands.ApiManagement.ServiceManagement.dll-help.Help.pshproj
+++ b/src/ResourceManager/ApiManagement/Commands.ApiManagement.ServiceManagement/Microsoft.Azure.Commands.ApiManagement.ServiceManagement.dll-help.Help.pshproj
@@ -409,8 +409,8 @@ true/false</ReturnTypeDescription>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -421,8 +421,8 @@ true/false</ReturnTypeDescription>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -644,8 +644,8 @@ true/false</ReturnTypeDescription>
     <CmdletObject verb="Get" noun="AzureApiManagementCertificate">
       <Name>Get-AzureRmApiManagementCertificate</Name>
       <GeneralHelp>
-        <Synopsis>Gets all or specific certificates.</Synopsis>
-        <Description>Gets all or specific certificates.</Description>
+        <Synopsis>Gets API Management certificates configured for authentication with backend.</Synopsis>
+        <Description>The Get-AzureRmApiManagementCertificate cmdlet gets all Azure API Management certificates or certificates that you specify which are configured for Authentication with the Backend.</Description>
         <Notes />
         <InputType />
         <InputUrl />
@@ -710,8 +710,8 @@ true/false</ReturnTypeDescription>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -722,8 +722,8 @@ true/false</ReturnTypeDescription>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -734,13 +734,13 @@ true/false</ReturnTypeDescription>
       </Parameters>
       <Examples>
         <Example>
-          <Name>Example 1</Name>
+          <Name>Example 1: Get all certificates</Name>
           <Cmd>Get-AzureRmApiManagementCertificate –Context $apimContext</Cmd>
           <Description>Get all certificates.</Description>
           <Output />
         </Example>
         <Example>
-          <Name>Example 2</Name>
+          <Name>Example 2: Get a certificate by its ID</Name>
           <Cmd>Get-AzureRmApiManagementCertificate –Context $apimContext –CertificateId 0123456789</Cmd>
           <Description>Get specific certificate.</Description>
           <Output />
@@ -1095,8 +1095,8 @@ true/false</ReturnTypeDescription>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -1107,8 +1107,8 @@ true/false</ReturnTypeDescription>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -2166,8 +2166,8 @@ Imported API</ReturnTypeDescription>
     <CmdletObject verb="New" noun="AzureApiManagementCertificate">
       <Name>New-AzureRmApiManagementCertificate</Name>
       <GeneralHelp>
-        <Synopsis>Creates new certificate.</Synopsis>
-        <Description>Creates new certificate.</Description>
+        <Synopsis>Creates an API Management certificate for authentication with backend.</Synopsis>
+        <Description>The New-AzureRmApiManagementCertificate cmdlet creates an Azure API Management certificate which can be configured for authentication with backend.</Description>
         <Notes />
         <InputType />
         <InputUrl />
@@ -2260,7 +2260,7 @@ Imported API</ReturnTypeDescription>
       </Parameters>
       <Examples>
         <Example>
-          <Name>Example 1</Name>
+          <Name>Example 1: Create and upload a certificate</Name>
           <Cmd>New-AzureRmApiManagementCertificate –Context $apimContext –PfxFilePath 'C:\contoso\certificates\apimanagement.pfx' –PfxPassword 1111</Cmd>
           <Description>Create/upload new certificate.</Description>
           <Output />
@@ -3137,8 +3137,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -3149,8 +3149,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -3354,8 +3354,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -3366,8 +3366,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -3391,8 +3391,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
     <CmdletObject verb="Remove" noun="AzureApiManagementCertificate">
       <Name>Remove-AzureRmApiManagementCertificate</Name>
       <GeneralHelp>
-        <Synopsis>Deletes existing certificate.</Synopsis>
-        <Description>Deletes existing certificate.</Description>
+        <Synopsis>Removes an API Management certificate configured for authentication with backend.</Synopsis>
+        <Description>The Remove-AzureRmApiManagementCertificate cmdlet removes an Azure API Management certificate.</Description>
         <Notes />
         <InputType />
         <InputUrl />
@@ -3474,8 +3474,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -3486,8 +3486,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -3594,8 +3594,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -3606,8 +3606,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -3724,8 +3724,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -3736,8 +3736,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -3868,8 +3868,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -3880,8 +3880,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -4015,8 +4015,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -4027,8 +4027,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -4232,8 +4232,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -4244,8 +4244,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -4361,8 +4361,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -4373,8 +4373,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -4905,8 +4905,8 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
     <CmdletObject verb="Set" noun="AzureApiManagementCertificate">
       <Name>Set-AzureRmApiManagementCertificate</Name>
       <GeneralHelp>
-        <Synopsis>Sets certificate data.</Synopsis>
-        <Description>Sets certificate data.</Description>
+        <Synopsis>Modifies an API Management certificate which is configured for authentication with backend.</Synopsis>
+        <Description>The Set-AzureRmApiManagementCertificate cmdlet modifies an Azure API Management certificate which is configured for authentication with backend.</Description>
         <Notes />
         <InputType />
         <InputUrl />
@@ -6402,8 +6402,8 @@ New-AzureRmApiManagementProperty -Context $apimContext -PropertyId 123 -Name pro
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -6414,8 +6414,8 @@ New-AzureRmApiManagementProperty -Context $apimContext -PropertyId 123 -Name pro
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -6522,8 +6522,8 @@ New-AzureRmApiManagementProperty -Context $apimContext -PropertyId 123 -Name pro
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -6534,8 +6534,8 @@ New-AzureRmApiManagementProperty -Context $apimContext -PropertyId 123 -Name pro
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -7122,8 +7122,8 @@ Set-AzureRmApiManagementProperty -Context $apimContext -PropertyId 123 -Tags $ta
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -7134,8 +7134,8 @@ Set-AzureRmApiManagementProperty -Context $apimContext -PropertyId 123 -Tags $ta
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -7520,8 +7520,8 @@ OpenId Connect Provider.</Description>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -7532,8 +7532,8 @@ OpenId Connect Provider.</Description>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -7646,8 +7646,8 @@ OpenId Connect Provider.</Description>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -7658,8 +7658,8 @@ OpenId Connect Provider.</Description>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -8016,8 +8016,8 @@ OpenId Connect Provider.</Description>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -8028,8 +8028,8 @@ OpenId Connect Provider.</Description>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -8127,8 +8127,8 @@ OpenId Connect Provider.</Description>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -8139,8 +8139,8 @@ OpenId Connect Provider.</Description>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -8265,8 +8265,8 @@ OpenId Connect Provider.</Description>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -8277,8 +8277,8 @@ OpenId Connect Provider.</Description>
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
diff --git a/src/ResourceManager/ApiManagement/Commands.ApiManagement.ServiceManagement/Microsoft.Azure.Commands.ApiManagement.ServiceManagement.dll-help.xml b/src/ResourceManager/ApiManagement/Commands.ApiManagement.ServiceManagement/Microsoft.Azure.Commands.ApiManagement.ServiceManagement.dll-help.xml
index 2409e8824dd7..134d0959a501 100644
--- a/src/ResourceManager/ApiManagement/Commands.ApiManagement.ServiceManagement/Microsoft.Azure.Commands.ApiManagement.ServiceManagement.dll-help.xml
+++ b/src/ResourceManager/ApiManagement/Commands.ApiManagement.ServiceManagement/Microsoft.Azure.Commands.ApiManagement.ServiceManagement.dll-help.xml
@@ -1452,7 +1452,7 @@ true/false</maml:para>
 	<command:details>
 		<command:name>Get-AzureRmApiManagementCertificate</command:name>
 		<maml:description>
-			<maml:para>Gets all or specific certificates.</maml:para>
+			<maml:para>Gets API Management certificates configured for authentication with backend.</maml:para>
 		</maml:description>
 		<maml:copyright>
 			<maml:para />
@@ -1462,7 +1462,7 @@ true/false</maml:para>
 		<dev:version />
 	</command:details>
 	<maml:description>
-		<maml:para>Gets all or specific certificates.</maml:para>
+		<maml:para>The Get-AzureRmApiManagementCertificate cmdlet gets all Azure API Management certificates or certificates that you specify which are configured for Authentication with the Backend.</maml:para>
 	</maml:description>
 	<command:syntax>
 		<command:syntaxItem>
@@ -1657,7 +1657,7 @@ true/false</maml:para>
 	</maml:alertSet>
 	<command:examples>
 		<command:example>
-			<maml:title>--------------------------  Example 1  --------------------------</maml:title>
+			<maml:title>--------------------------  Example 1: Get all certificates  --------------------------</maml:title>
 			<maml:introduction>
 				<maml:paragraph>PS C:\&gt;</maml:paragraph>
 			</maml:introduction>
@@ -1677,7 +1677,7 @@ true/false</maml:para>
 			</command:commandLines>
 		</command:example>
 		<command:example>
-			<maml:title>--------------------------  Example 2  --------------------------</maml:title>
+			<maml:title>--------------------------  Example 2: Get a certificate by its ID  --------------------------</maml:title>
 			<maml:introduction>
 				<maml:paragraph>PS C:\&gt;</maml:paragraph>
 			</maml:introduction>
@@ -5250,7 +5250,7 @@ Imported API</maml:para>
 	<command:details>
 		<command:name>New-AzureRmApiManagementCertificate</command:name>
 		<maml:description>
-			<maml:para>Creates new certificate.</maml:para>
+			<maml:para>Creates an API Management certificate for authentication with backend.</maml:para>
 		</maml:description>
 		<maml:copyright>
 			<maml:para />
@@ -5260,7 +5260,7 @@ Imported API</maml:para>
 		<dev:version />
 	</command:details>
 	<maml:description>
-		<maml:para>Creates new certificate.</maml:para>
+		<maml:para>The New-AzureRmApiManagementCertificate cmdlet creates an Azure API Management certificate which can be configured for authentication with backend.</maml:para>
 	</maml:description>
 	<command:syntax>
 		<command:syntaxItem>
@@ -5474,7 +5474,7 @@ Imported API</maml:para>
 	</maml:alertSet>
 	<command:examples>
 		<command:example>
-			<maml:title>--------------------------  Example 1  --------------------------</maml:title>
+			<maml:title>--------------------------  Example 1: Create and upload a certificate  --------------------------</maml:title>
 			<maml:introduction>
 				<maml:paragraph>PS C:\&gt;</maml:paragraph>
 			</maml:introduction>
@@ -7690,7 +7690,7 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
 	<command:details>
 		<command:name>Remove-AzureRmApiManagementCertificate</command:name>
 		<maml:description>
-			<maml:para>Deletes existing certificate.</maml:para>
+			<maml:para>Removes an API Management certificate configured for authentication with backend.</maml:para>
 		</maml:description>
 		<maml:copyright>
 			<maml:para />
@@ -7700,7 +7700,7 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
 		<dev:version />
 	</command:details>
 	<maml:description>
-		<maml:para>Deletes existing certificate.</maml:para>
+		<maml:para>The Remove-AzureRmApiManagementCertificate cmdlet removes an Azure API Management certificate.</maml:para>
 	</maml:description>
 	<command:syntax>
 		<command:syntaxItem>
@@ -10702,7 +10702,7 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
 	<command:details>
 		<command:name>Set-AzureRmApiManagementCertificate</command:name>
 		<maml:description>
-			<maml:para>Sets certificate data.</maml:para>
+			<maml:para>Modifies an API Management certificate which is configured for authentication with backend.</maml:para>
 		</maml:description>
 		<maml:copyright>
 			<maml:para />
@@ -10712,7 +10712,7 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
 		<dev:version />
 	</command:details>
 	<maml:description>
-		<maml:para>Sets certificate data.</maml:para>
+		<maml:para>The Set-AzureRmApiManagementCertificate cmdlet modifies an Azure API Management certificate which is configured for authentication with backend.</maml:para>
 	</maml:description>
 	<command:syntax>
 		<command:syntaxItem>
@@ -12951,7 +12951,7 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
 				</maml:description>
 				<command:parameterValue required="true" variableLength="false">PsApiManagementContext</command:parameterValue>
 			</command:parameter>
-			<command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named">
+			<command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named">
 				<maml:name>LoggerId</maml:name>
 				<maml:description>
 					<maml:para>Identifier of a logger. If specified will try to find logger by the identifier. This parameter is optional.</maml:para>
@@ -13011,7 +13011,7 @@ New-AzureRmApiManagementOperation –Context $apimContext –ApiId $apiId –Ope
 			</dev:type>
 			<dev:defaultValue></dev:defaultValue>
 		</command:parameter>
-		<command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named">
+		<command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named">
 			<maml:name>LoggerId</maml:name>
 			<maml:description>
 				<maml:para>Identifier of a logger. If specified will try to find logger by the identifier. This parameter is optional.</maml:para>
@@ -17047,7 +17047,7 @@ OpenId Connect Provider.</maml:para>
 				</maml:description>
 				<command:parameterValue required="true" variableLength="false">PsApiManagementContext</command:parameterValue>
 			</command:parameter>
-			<command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named">
+			<command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named">
 				<maml:name>Type</maml:name>
 				<maml:description>
 					<maml:para>Identifier of a Identity Provider. If specified will try to find identity provider configuration by the identifier. This parameter is optional.</maml:para>
@@ -17107,7 +17107,7 @@ OpenId Connect Provider.</maml:para>
 			</dev:type>
 			<dev:defaultValue></dev:defaultValue>
 		</command:parameter>
-		<command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named">
+		<command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named">
 			<maml:name>Type</maml:name>
 			<maml:description>
 				<maml:para>Identifier of a Identity Provider. If specified will try to find identity provider configuration by the identifier. This parameter is optional.</maml:para>
diff --git a/src/ResourceManager/ApiManagement/Commands.ApiManagement/Microsoft.Azure.Commands.ApiManagement.dll-help.Help.pshproj b/src/ResourceManager/ApiManagement/Commands.ApiManagement/Microsoft.Azure.Commands.ApiManagement.dll-help.Help.pshproj
index cd47fa3f6174..9ba450d99fd4 100644
--- a/src/ResourceManager/ApiManagement/Commands.ApiManagement/Microsoft.Azure.Commands.ApiManagement.dll-help.Help.pshproj
+++ b/src/ResourceManager/ApiManagement/Commands.ApiManagement/Microsoft.Azure.Commands.ApiManagement.dll-help.Help.pshproj
@@ -536,7 +536,7 @@ Update-AzureRmApiManagementDeployments</Cmd>
         <CommandParameterSetInfo2 Name="__AllParameterSets" Params="ResourceGroupName Name Location Organization AdminEmail Sku Capacity VpnType VirtualNetwork Tags AdditionalRegions Verbose Debug ErrorAction WarningAction InformationAction ErrorVariable WarningVariable InformationVariable OutVariable OutBuffer PipelineVariable" />
       </ParamSets>
       <Syntax>
-        <string>New-AzureRmApiManagement -ResourceGroupName &lt;String&gt; -Name &lt;String&gt; -Location &lt;String&gt; -Organization &lt;String&gt; -AdminEmail &lt;String&gt; [-Sku &lt;Nullable`1[PsApiManagementSku]&gt;] [-Capacity &lt;Nullable`1[Int32]&gt;] [-VpnType &lt;PsApiManagementVpnType&gt;] [-VirtualNetwork &lt;PsApiManagementVirtualNetwork&gt;] [-Tags &lt;Dictionary`2[String]&gt;] [-AdditionalRegions &lt;PsApiManagementRegion[]&gt;] [-InformationAction &lt;ActionPreference&gt;] [-InformationVariable &lt;String&gt;]</string>
+        <string>New-AzureRmApiManagement -ResourceGroupName &lt;String&gt; -Name &lt;String&gt; -Location &lt;String&gt; -Organization &lt;String&gt; -AdminEmail &lt;String&gt; [-Sku &lt;Nullable`1[PsApiManagementSku]&gt; {Developer | Standard | Premium} ] [-Capacity &lt;Nullable`1[Int32]&gt;] [-VpnType &lt;PsApiManagementVpnType&gt; {None | External | Internal} ] [-VirtualNetwork &lt;PsApiManagementVirtualNetwork&gt;] [-Tags &lt;Dictionary`2[String]&gt;] [-AdditionalRegions &lt;PsApiManagementRegion[]&gt;] [-InformationAction &lt;ActionPreference&gt;] [-InformationVariable &lt;String&gt;]</string>
       </Syntax>
       <Parameters>
         <ParameterDescription type="String" varLen="false" required="true" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="true" isPos="false" pos="named" globbing="false">
@@ -584,6 +584,8 @@ Update-AzureRmApiManagementDeployments</Cmd>
           <Attributes>
             <string>System.Management.Automation.ParameterAttribute</string>
             <string>System.Management.Automation.ValidateNotNullOrEmptyAttribute</string>
+            <string>System.Management.Automation.ValidateLengthAttribute</string>
+            <string>System.Management.Automation.ValidatePatternAttribute</string>
           </Attributes>
           <Aliases />
           <Description>The originating e-mail address for all e-mail notifications sent from the API Management system.</Description>
@@ -593,6 +595,8 @@ Update-AzureRmApiManagementDeployments</Cmd>
           <Name>Sku</Name>
           <Attributes>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.ValidateSetAttribute</string>
+            <string>System.Management.Automation.PSDefaultValueAttribute</string>
           </Attributes>
           <Aliases />
           <Description>The tier of the Azure API Management service. Valid values are Developer, Standard and Premium . Default value is Developer</Description>
@@ -602,6 +606,8 @@ Update-AzureRmApiManagementDeployments</Cmd>
           <Name>Capacity</Name>
           <Attributes>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.ValidateRangeAttribute</string>
+            <string>System.Management.Automation.PSDefaultValueAttribute</string>
           </Attributes>
           <Aliases />
           <Description>Sku capacity of the Azure API Management service. Default value is 1.</Description>
@@ -620,6 +626,8 @@ Update-AzureRmApiManagementDeployments</Cmd>
           <Name>VpnType</Name>
           <Attributes>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.ValidateSetAttribute</string>
+            <string>System.Management.Automation.PSDefaultValueAttribute</string>
           </Attributes>
           <Aliases />
           <Description>Virtual Network Type of the ApiManagement Deployment. Valid Values are 
@@ -966,8 +974,8 @@ Update-AzureRmApiManagementDeployment –ResourceGroupName ContosoGroup –Name
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>WhatIf</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>wi</string>
@@ -978,8 +986,8 @@ Update-AzureRmApiManagementDeployment –ResourceGroupName ContosoGroup –Name
         <ParameterDescription type="SwitchParameter" varLen="false" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Confirm</Name>
           <Attributes>
-            <string>System.Management.Automation.AliasAttribute</string>
             <string>System.Management.Automation.ParameterAttribute</string>
+            <string>System.Management.Automation.AliasAttribute</string>
           </Attributes>
           <Aliases>
             <string>cf</string>
@@ -1472,13 +1480,13 @@ Set-AzureApiHostnames -Name ContosoApi -ResourceGroupName Contoso –PortalHostn
       </Parameters>
       <Examples>
         <Example>
-          <Name>Example 1</Name>
+          <Name>Example 1: Update a deployment of an ApiManagement instance</Name>
           <Cmd>PS C:\&gt; Update-AzureRmApiManagementDeployment -ResourceGroupName Contoso -Name ContosoApi –Sku “Standard” –Capacity 3</Cmd>
           <Description>Command to update deployment of an ApiManagement to 3 unit ‘Standard’.</Description>
           <Output />
         </Example>
         <Example>
-          <Name>Example 2</Name>
+          <Name>Example 2: Get an ApiManagement instance and rescale it</Name>
           <Cmd>$apiManagement = Get-AzureRmApiManagement –ResourceGroupName Contoso –Name ContosoApi
 $apiManagement.Sku = “Premium”
 $apiManagement.Capacity = 5
@@ -1488,6 +1496,39 @@ Update-AzureRmApiManagementDeployment –ApiManagement $apiManagement
           <Description>Script to get an ApiManagement, scale to 5 ‘Premium’ units and add additional 3 unit ‘Premium’ region.</Description>
           <Output />
         </Example>
+        <Example>
+          <Name>Example 3: Move API Management instance inside a Virtual Network</Name>
+          <Cmd>PS C:\&gt;# Create a Virtual Network Object
+PS C:\&gt;$virtualNetwork = New-AzureRmApiManagementVirtualNetwork -Location "North Central US" -SubnetResourceId
+"/subscriptions/20010444-2b48-4245-a95c-090db6312d5f/resourceGroups/ContosoGroup/providers/Microsoft.Network/virtualNe
+tworks/contosoVnet/subnets/default"
+
+PS C:\&gt;# Get the service
+PS C:\&gt;$service = Get-AzureRmApiManagement -ResourceGroupName "ContosoGroup" -Name "contosoapim"
+
+PS C:\&gt;$service.VirtualNetwork = $virtualNetwork
+PS C:\&gt;$service.VpnType = "External"
+
+PS C:\&gt;# Update the Deployment with Virtual Network
+PS C:\&gt;Update-AzureRmApiManagementDeployment -ApiManagement $service
+</Cmd>
+          <Description>This example moves an existing API Management deployment inside a Virtual Network configures external *VpnType*</Description>
+          <Output />
+        </Example>
+        <Example>
+          <Name>Example 4: Update deployment (external VNET)</Name>
+          <Cmd> PS C:\&gt; $virtualNetwork = New-AzureRmApiManagementVirtualNetwork -Location "East US" -SubnetResourceId "/subscriptions/a8ff56dc-3bc7-4174-a1e8-3726ab15d0e2/resourceGroups/Api-Default-West-US/providers/Microsoft.ClassicNetwork/virtualNetworks/dfVirtualNetwork/subnets/backendSubnet"
+  PS C:\&gt; Update-AzureRmApiManagementDeployment -ResourceGroupName "ContosoGroup" -Name "ContosoApi" -VirtualNetwork $virtualNetwork -VpnType "External"</Cmd>
+          <Description>This command updates an existing API Management deployment and joins to an external *VpnType*.</Description>
+          <Output />
+        </Example>
+        <Example>
+          <Name>Example 5: Update deployment (internal VNET)</Name>
+          <Cmd> PS C:\&gt; $virtualNetwork = New-AzureRmApiManagementVirtualNetwork -Location "East US" -SubnetResourceId "/subscriptions/a8ff56dc-3bc7-4174-a1e8-3726ab15d0e2/resourceGroups/Api-Default-West-US/providers/Microsoft.ClassicNetwork/virtualNetworks/dfVirtualNetwork/subnets/backendSubnet"
+  PS C:\&gt; Update-AzureRmApiManagementDeployment -ResourceGroupName "ContosoGroup" -Name "ContosoApi" -VirtualNetwork $virtualNetwork -VpnType "Internal"</Cmd>
+          <Description>This command updates an existing API Management deployment and joins to an internal VpnType.</Description>
+          <Output />
+        </Example>
       </Examples>
       <RelatedLinks />
       <SupportInformation ad="false" rsat="false" ps2="false" ps3="false" ps4="false" ps5="false" wxp="false" wv="false" w7="false" w8="false" w81="false" w2k3s="false" w2k3e="false" w2k3d="false" w2k8s="false" w2k8e="false" w2k8d="false" w2k8r2s="false" w2k8r2e="false" w2k8r2d="false" w2k12s="false" w2k12d="false" w2k12r2s="false" w2k12r2d="false" />
@@ -1611,7 +1652,7 @@ Update-AzureRmApiManagementDeployment –ApiManagement $apiManagement
         <string>New-AzureRmApiManagementRegion -Location &lt;String&gt; [-Capacity &lt;Nullable`1[Int32]&gt;] [-VirtualNetwork &lt;PsApiManagementVirtualNetwork&gt;] [-InformationAction &lt;ActionPreference&gt;] [-InformationVariable &lt;String&gt;]</string>
       </Syntax>
       <Parameters>
-        <ParameterDescription type="String" varLen="false" required="true" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="true" isPos="false" pos="named" globbing="false">
+        <ParameterDescription type="String" varLen="false" required="true" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Location</Name>
           <Attributes>
             <string>System.Management.Automation.ParameterAttribute</string>
@@ -1621,7 +1662,7 @@ Update-AzureRmApiManagementDeployment –ApiManagement $apiManagement
           <Description>Location of the additional deployment region.</Description>
           <DefaultValue />
         </ParameterDescription>
-        <ParameterDescription type="Nullable`1[Int32]" varLen="true" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="true" isPos="false" pos="named" globbing="false">
+        <ParameterDescription type="Nullable`1[Int32]" varLen="true" required="false" dynamic="false" pipeRemaining="false" pipe="false" pipeProp="false" isPos="false" pos="named" globbing="false">
           <Name>Capacity</Name>
           <Attributes>
             <string>System.Management.Automation.ParameterAttribute</string>
diff --git a/src/ResourceManager/ApiManagement/Commands.ApiManagement/Microsoft.Azure.Commands.ApiManagement.dll-help.xml b/src/ResourceManager/ApiManagement/Commands.ApiManagement/Microsoft.Azure.Commands.ApiManagement.dll-help.xml
index c07bbf589eed..616f6f1798bd 100644
--- a/src/ResourceManager/ApiManagement/Commands.ApiManagement/Microsoft.Azure.Commands.ApiManagement.dll-help.xml
+++ b/src/ResourceManager/ApiManagement/Commands.ApiManagement/Microsoft.Azure.Commands.ApiManagement.dll-help.xml
@@ -36,7 +36,7 @@
 			<command:parameter required="false" variableLength="true" globbing="false" pipelineInput="false" position="named">
 				<maml:name>Sku</maml:name>
 				<maml:description>
-					<maml:para>Tier of the deployment region. Valid and Default value is Premium.</maml:para>
+					<maml:para>Tier of the deployment region. Valid values are Developer, Standard and Premium. Default value is Developer.</maml:para>
 				</maml:description>
 				<command:parameterValue required="true" variableLength="true">Nullable`1[PsApiManagementSku]</command:parameterValue>
 			</command:parameter>
@@ -3043,7 +3043,7 @@ Set-AzureApiHostnames -Name ContosoApi -ResourceGroupName Contoso –PortalHostn
 	</maml:alertSet>
 	<command:examples>
 		<command:example>
-			<maml:title>--------------------------  Example 1  --------------------------</maml:title>
+			<maml:title>--------------------------  Example 1: Update a deployment of an ApiManagement instance  --------------------------</maml:title>
 			<maml:introduction>
 				<maml:paragraph>PS C:\&gt;</maml:paragraph>
 			</maml:introduction>
@@ -3063,7 +3063,7 @@ Set-AzureApiHostnames -Name ContosoApi -ResourceGroupName Contoso –PortalHostn
 			</command:commandLines>
 		</command:example>
 		<command:example>
-			<maml:title>--------------------------  Example 2  --------------------------</maml:title>
+			<maml:title>--------------------------  Example 2: Get an ApiManagement instance and rescale it  --------------------------</maml:title>
 			<maml:introduction>
 				<maml:paragraph>PS C:\&gt;</maml:paragraph>
 			</maml:introduction>
@@ -3087,6 +3087,81 @@ Update-AzureRmApiManagementDeployment –ApiManagement $apiManagement
 				</command:commandLine>
 			</command:commandLines>
 		</command:example>
+		<command:example>
+			<maml:title>--------------------------  Example 3: Move API Management instance inside a Virtual Network  --------------------------</maml:title>
+			<maml:introduction>
+				<maml:paragraph>PS C:\&gt;</maml:paragraph>
+			</maml:introduction>
+			<dev:code>PS C:\&gt;# Create a Virtual Network Object
+PS C:\&gt;$virtualNetwork = New-AzureRmApiManagementVirtualNetwork -Location &quot;North Central US&quot; -SubnetResourceId
+&quot;/subscriptions/20010444-2b48-4245-a95c-090db6312d5f/resourceGroups/ContosoGroup/providers/Microsoft.Network/virtualNe
+tworks/contosoVnet/subnets/default&quot;
+
+PS C:\&gt;# Get the service
+PS C:\&gt;$service = Get-AzureRmApiManagement -ResourceGroupName &quot;ContosoGroup&quot; -Name &quot;contosoapim&quot;
+
+PS C:\&gt;$service.VirtualNetwork = $virtualNetwork
+PS C:\&gt;$service.VpnType = &quot;External&quot;
+
+PS C:\&gt;# Update the Deployment with Virtual Network
+PS C:\&gt;Update-AzureRmApiManagementDeployment -ApiManagement $service
+</dev:code>
+			<dev:remarks>
+				<maml:para>This example moves an existing API Management deployment inside a Virtual Network configures external *VpnType*</maml:para>
+				<maml:para />
+				<maml:para />
+				<maml:para></maml:para>
+			</dev:remarks>
+			<command:commandLines>
+				<command:commandLine>
+					<command:commandText>
+						<maml:para />
+					</command:commandText>
+				</command:commandLine>
+			</command:commandLines>
+		</command:example>
+		<command:example>
+			<maml:title>--------------------------  Example 4: Update deployment (external VNET)  --------------------------</maml:title>
+			<maml:introduction>
+				<maml:paragraph>PS C:\&gt;</maml:paragraph>
+			</maml:introduction>
+			<dev:code> PS C:\&gt; $virtualNetwork = New-AzureRmApiManagementVirtualNetwork -Location &quot;East US&quot; -SubnetResourceId &quot;/subscriptions/a8ff56dc-3bc7-4174-a1e8-3726ab15d0e2/resourceGroups/Api-Default-West-US/providers/Microsoft.ClassicNetwork/virtualNetworks/dfVirtualNetwork/subnets/backendSubnet&quot;
+  PS C:\&gt; Update-AzureRmApiManagementDeployment -ResourceGroupName &quot;ContosoGroup&quot; -Name &quot;ContosoApi&quot; -VirtualNetwork $virtualNetwork -VpnType &quot;External&quot;</dev:code>
+			<dev:remarks>
+				<maml:para>This command updates an existing API Management deployment and joins to an external *VpnType*.</maml:para>
+				<maml:para />
+				<maml:para />
+				<maml:para></maml:para>
+			</dev:remarks>
+			<command:commandLines>
+				<command:commandLine>
+					<command:commandText>
+						<maml:para />
+					</command:commandText>
+				</command:commandLine>
+			</command:commandLines>
+		</command:example>
+		<command:example>
+			<maml:title>--------------------------  Example 5: Update deployment (internal VNET)  --------------------------</maml:title>
+			<maml:introduction>
+				<maml:paragraph>PS C:\&gt;</maml:paragraph>
+			</maml:introduction>
+			<dev:code> PS C:\&gt; $virtualNetwork = New-AzureRmApiManagementVirtualNetwork -Location &quot;East US&quot; -SubnetResourceId &quot;/subscriptions/a8ff56dc-3bc7-4174-a1e8-3726ab15d0e2/resourceGroups/Api-Default-West-US/providers/Microsoft.ClassicNetwork/virtualNetworks/dfVirtualNetwork/subnets/backendSubnet&quot;
+  PS C:\&gt; Update-AzureRmApiManagementDeployment -ResourceGroupName &quot;ContosoGroup&quot; -Name &quot;ContosoApi&quot; -VirtualNetwork $virtualNetwork -VpnType &quot;Internal&quot;</dev:code>
+			<dev:remarks>
+				<maml:para>This command updates an existing API Management deployment and joins to an internal VpnType.</maml:para>
+				<maml:para />
+				<maml:para />
+				<maml:para></maml:para>
+			</dev:remarks>
+			<command:commandLines>
+				<command:commandLine>
+					<command:commandText>
+						<maml:para />
+					</command:commandText>
+				</command:commandLine>
+			</command:commandLines>
+		</command:example>
 	</command:examples>
 	<maml:relatedLinks>
 	</maml:relatedLinks>
@@ -3305,14 +3380,14 @@ Update-AzureRmApiManagementDeployment –ApiManagement $apiManagement
 	<command:syntax>
 		<command:syntaxItem>
 			<maml:name>New-AzureRmApiManagementRegion</maml:name>
-			<command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named">
+			<command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named">
 				<maml:name>Location</maml:name>
 				<maml:description>
 					<maml:para>Location of the additional deployment region.</maml:para>
 				</maml:description>
 				<command:parameterValue required="true" variableLength="false">String</command:parameterValue>
 			</command:parameter>
-			<command:parameter required="false" variableLength="true" globbing="false" pipelineInput="true (ByPropertyName)" position="named">
+			<command:parameter required="false" variableLength="true" globbing="false" pipelineInput="false" position="named">
 				<maml:name>Capacity</maml:name>
 				<maml:description>
 					<maml:para>Sku capacity of the Azure API Management service additional region. Default value is 1.</maml:para>
@@ -3343,7 +3418,7 @@ Update-AzureRmApiManagementDeployment –ApiManagement $apiManagement
 		</command:syntaxItem>
 	</command:syntax>
 	<command:parameters>
-		<command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named">
+		<command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named">
 			<maml:name>Location</maml:name>
 			<maml:description>
 				<maml:para>Location of the additional deployment region.</maml:para>
@@ -3355,7 +3430,7 @@ Update-AzureRmApiManagementDeployment –ApiManagement $apiManagement
 			</dev:type>
 			<dev:defaultValue></dev:defaultValue>
 		</command:parameter>
-		<command:parameter required="false" variableLength="true" globbing="false" pipelineInput="true (ByPropertyName)" position="named">
+		<command:parameter required="false" variableLength="true" globbing="false" pipelineInput="false" position="named">
 			<maml:name>Capacity</maml:name>
 			<maml:description>
 				<maml:para>Sku capacity of the Azure API Management service additional region. Default value is 1.</maml:para>