AzureRM.ApiManagement

1.1.1

Microsoft.Azure.Commands.ApiManagement.dll-help.xml

                                <?xml version="1.0" encoding="utf-8"?>

<helpItems xmlns="http://msh" schema="maml">

  <!-- Updatable Help Version 2.0.2.0 -->

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Add-AzureRmApiManagementRegion</command:name>

      <maml:description>

        <maml:para>Adds new deployment regions to a PsApiManagement instance.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>Add</command:verb>

      <command:noun>AzureRmApiManagementRegion</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The Add-AzureRmApiManagementRegion cmdlet adds new instance of type PsApiManagementRegion to the collection of AdditionalRegions of provided instance of type Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. This cmdlet does not deploy anything by itself but updates instance of PsApiManagement in-memory. To update a deployment of an API Management pass the modified PsApiManagement Instance to Update-AzureRmApiManagementDeployment.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Add-AzureRmApiManagementRegion</maml:name>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>Capacity</maml:name>

          <maml:description>

            <maml:para>Specifies the SKU capacity of the deployment region.</maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="true">Int32</command:parameterValue>

        </command:parameter>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>Sku</maml:name>

          <maml:description>

            <maml:para>Specifies the tier of the deployment region. Valid values are:

-- Developer

-- Standard

-- Premium</maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="true">PsApiManagementSku</command:parameterValue>

        </command:parameter>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>VirtualNetwork</maml:name>

          <maml:description>

            <maml:para>Specifies a virtual network configuration.</maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="false">PsApiManagementVirtualNetwork</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByValue)" position="named" aliases="none">

          <maml:name>ApiManagement</maml:name>

          <maml:description>

            <maml:para>Specifies the PsApiManagement instance that this cmdlet adds additional deployment regions to.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">PsApiManagement</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>Location</maml:name>

          <maml:description>

            <maml:para>Specifies the location of the new deployment region.</maml:para>

            <maml:para>Valid values are:

-- North Central US

-- South Central US

-- Central US

-- West Europe

-- North Europe

-- West US

-- East US

-- East US 2

-- Japan East

-- Japan West

-- Brazil South

-- Southeast Asia

-- East Asia

-- Australia East

-- Australia Southeast</maml:para>

          </maml:description>

          <command:parameterValueGroup>

            <command:parameterValue required="true" variableLength="false">North Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">South Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">West Europe</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">North Europe</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">West US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East US 2</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Japan East</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Japan West</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Brazil South</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Southeast Asia</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East Asia</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Australia East</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Australia Southeast</command:parameterValue>

          </command:parameterValueGroup>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByValue)" position="named" aliases="none">

        <maml:name>ApiManagement</maml:name>

        <maml:description>

          <maml:para>Specifies the PsApiManagement instance that this cmdlet adds additional deployment regions to.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">PsApiManagement</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagement</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>Capacity</maml:name>

        <maml:description>

          <maml:para>Specifies the SKU capacity of the deployment region.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="true">Int32</command:parameterValue>

        <dev:type>

          <maml:name>Int32</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>Location</maml:name>

        <maml:description>

          <maml:para>Specifies the location of the new deployment region.</maml:para>

          <maml:para>Valid values are:

-- North Central US

-- South Central US

-- Central US

-- West Europe

-- North Europe

-- West US

-- East US

-- East US 2

-- Japan East

-- Japan West

-- Brazil South

-- Southeast Asia

-- East Asia

-- Australia East

-- Australia Southeast</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>Sku</maml:name>

        <maml:description>

          <maml:para>Specifies the tier of the deployment region. Valid values are:

-- Developer

-- Standard

-- Premium</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="true">PsApiManagementSku</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagementSku</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>VirtualNetwork</maml:name>

        <maml:description>

          <maml:para>Specifies a virtual network configuration.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">PsApiManagementVirtualNetwork</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagementVirtualNetwork</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <maml:alertSet>

      <maml:title />

      <maml:alert>

        <maml:para>The cmdlet writes updated PsApiManagement instance to pipeline.</maml:para>

      </maml:alert>

    </maml:alertSet>

    <command:examples>

      <command:example>

        <maml:title>Example 1: Add new deployment regions to a PsApiManagement instance</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Add-AzureRmApiManagementRegion -ApiManagement $ApiManagement -Location "East US" -Sku "Premium" -Capacity 2

</dev:code>

        <dev:remarks>

          <maml:para>This command adds two premium SKU units and the region named East US to the PsApiManagement instance.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

      <command:example>

        <maml:title>Example 2: Add new deployment regions to a PsApiManagement instance and then update deployment</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Get-AzureRmApiManagement -ResourceGroupName "Contoso" -Name "ContosoApi" | Add-AzureRmApiManagementRegion -Location "East US" -Sku "Premium" -Capacity 2 | Update-AzureRmApiManagementDeployments

</dev:code>

        <dev:remarks>

          <maml:para>This command gets a PsApiManagement object, adds two premium SKU units for the region named East US, and then updates deployment.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Remove-AzureRmApiManagementRegion</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Update-AzureRmApiManagementRegion</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Update-AzureRmApiManagementDeployment</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Backup-AzureRmApiManagement</command:name>

      <maml:description>

        <maml:para>Backs up an API Management service. </maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>Backup</command:verb>

      <command:noun>AzureRmApiManagement</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The Backup-AzureRmApiManagement cmdlet backs up an instance of an Azure API Management service. This cmdlet stores the backup as an Azure Storage blob.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Backup-AzureRmApiManagement</maml:name>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>PassThru</maml:name>

          <maml:description>

            <maml:para>Indicates that this cmdlet returns the backed up PsApiManagement object, if the operation succeeds.</maml:para>

          </maml:description>

        </command:parameter>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>TargetBlobName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the blob for the backup. If the blob does not exist, this cmdlet creates it. This cmdlet generates a default value based on the following pattern:

{Name}-{yyyy-MM-dd-HH-mm}.apimbackup</maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Name</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the API Management deployment that this cmdlet backs up.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>ResourceGroupName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the of resource group under which the API Management deployment exists. </maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>StorageContext</maml:name>

          <maml:description>

            <maml:para>Specifies a storage connection context.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">AzureStorageContext</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>TargetContainerName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the container of the blob for the backup. If the container does not exist, this cmdlet creates it. </maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Name</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the API Management deployment that this cmdlet backs up.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>PassThru</maml:name>

        <maml:description>

          <maml:para>Indicates that this cmdlet returns the backed up PsApiManagement object, if the operation succeeds.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>

        <dev:type>

          <maml:name>SwitchParameter</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>ResourceGroupName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the of resource group under which the API Management deployment exists. </maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>StorageContext</maml:name>

        <maml:description>

          <maml:para>Specifies a storage connection context.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">AzureStorageContext</command:parameterValue>

        <dev:type>

          <maml:name>AzureStorageContext</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>TargetBlobName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the blob for the backup. If the blob does not exist, this cmdlet creates it. This cmdlet generates a default value based on the following pattern:

{Name}-{yyyy-MM-dd-HH-mm}.apimbackup</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>TargetContainerName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the container of the blob for the backup. If the container does not exist, this cmdlet creates it. </maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Back up an API Management service </maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Backup-AzureRmApiManagement -ResourceGroupName "ContosoGroup02" -Name "ContosoApi" -StorageContext $StorageContext -TargetContainerName "ContosoBackups" -TargetBlobName "ContosoBackup.apimbackup"

</dev:code>

        <dev:remarks>

          <maml:para>This command backs up an API Management service to a Storage blob.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Get-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>New-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Remove-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Restore-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Get-AzureRmApiManagementSsoToken</command:name>

      <maml:description>

        <maml:para>Gets a link with an SSO token to a deployed management portal of an API Management service.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>Get</command:verb>

      <command:noun>AzureRmApiManagementSsoToken</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The Get-AzureRMApiManagementSsoToken cmdlet returns a link (URL) containing a single sign-on (SSO) token to a deployed management portal of an API Management service.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Get-AzureRmApiManagementSsoToken</maml:name>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Name</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the API Management instance.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>ResourceGroupName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of resource group under which API Management exists.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Name</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the API Management instance.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>ResourceGroupName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of resource group under which API Management exists.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Get the SSO token of an API Management service</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Get-AzureRmApiManagementSsoToken -ResourceGroupName "Contoso" -Name "ContosoApi"

</dev:code>

        <dev:remarks>

          <maml:para>This command gets the SSO token of an API Management service.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Get-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Get-AzureRmApiManagement</command:name>

      <maml:description>

        <maml:para>Gets a list or a particular API Management Service description.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>Get</command:verb>

      <command:noun>AzureRmApiManagement</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The Get-AzureRMApiManagement cmdlet gets a list of all API Management services under subscription or specified resource group or a particular API Management.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Get-AzureRmApiManagement</maml:name>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Name</maml:name>

          <maml:description>

            <maml:para>Specifies the name of API Management service.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named" aliases="none">

          <maml:name>ResourceGroupName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the resource group under in which this cmdlet gets the API Management service.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

      <command:syntaxItem>

        <maml:name>Get-AzureRmApiManagement</maml:name>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>ResourceGroupName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the resource group under in which this cmdlet gets the API Management service.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Name</maml:name>

        <maml:description>

          <maml:para>Specifies the name of API Management service.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true (ByPropertyName)" position="named" aliases="none">

        <maml:name>ResourceGroupName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the resource group under in which this cmdlet gets the API Management service.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Get all API Management services</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Get-AzureRmApiManagement

</dev:code>

        <dev:remarks>

          <maml:para>This command gets all API Management services within a subscription.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

      <command:example>

        <maml:title>Example 2: Get all API Management services by a specific name</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Get-AzureRmApiManagement -ResourceGroupName "ContosoGroup" -Name "ContosoApi"

</dev:code>

        <dev:remarks>

          <maml:para>This command gets all API Management service by name.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Backup-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>New-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Remove-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Restore-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Import-AzureRmApiManagementHostnameCertificate</command:name>

      <maml:description>

        <maml:para>Imports a certificate in a PFX format for an API Management Service.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>Import</command:verb>

      <command:noun>AzureRmApiManagementHostnameCertificate</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The Import-AzureRmApiManagementHostnameCertificate cmdlet imports a certificate in a PFX format for an API Management Service. The certificate is to be used for custom hostnames configuration.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Import-AzureRmApiManagementHostnameCertificate</maml:name>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>PassThru</maml:name>

          <maml:description>

            <maml:para>Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.</maml:para>

          </maml:description>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>HostnameType</maml:name>

          <maml:description>

            <maml:para>Specifies the host name type that this cmdlet loads the certificate for.</maml:para>

            <maml:para>Valid values are:

-- Proxy

-- Portal</maml:para>

          </maml:description>

          <command:parameterValueGroup>

            <command:parameterValue required="true" variableLength="false">Proxy</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Portal</command:parameterValue>

          </command:parameterValueGroup>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Name</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the API Management deployment that this cmdlet imports.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>PfxPassword</maml:name>

          <maml:description>

            <maml:para>Specifies the password for the .pfx certificate file.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>PfxPath</maml:name>

          <maml:description>

            <maml:para>Specifies the path to a .pfx certificate file.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>ResourceGroupName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the of resource group under which the API Management deployment exists.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>HostnameType</maml:name>

        <maml:description>

          <maml:para>Specifies the host name type that this cmdlet loads the certificate for.</maml:para>

          <maml:para>Valid values are:

-- Proxy

-- Portal</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">PsApiManagementHostnameType</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagementHostnameType</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Name</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the API Management deployment that this cmdlet imports.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>PassThru</maml:name>

        <maml:description>

          <maml:para>Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>

        <dev:type>

          <maml:name>SwitchParameter</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>PfxPassword</maml:name>

        <maml:description>

          <maml:para>Specifies the password for the .pfx certificate file.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>PfxPath</maml:name>

        <maml:description>

          <maml:para>Specifies the path to a .pfx certificate file.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>ResourceGroupName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the of resource group under which the API Management deployment exists.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Import a API Management hostname certificate</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Import-AzureRmApiManagementHostnameCertificate -Name "ContosoApi" -ResourceGroupName Contoso -HostnameType "Proxy" -PfxPath "C:\proxycert.pfx" -PfxPassword "CertSecret"

</dev:code>

        <dev:remarks>

          <maml:para>This command imports a certificate for a proxy custom hostname.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>New-AzureRmApiManagementHostnameConfiguration</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Set-AzureRmApiManagementHostnames</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>New-AzureRmApiManagementHostnameConfiguration</command:name>

      <maml:description>

        <maml:para>Creates an instance of PsApiManagementHostnameConfiguration.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>New</command:verb>

      <command:noun>AzureRmApiManagementHostnameConfiguration</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The New-AzureRMApiManagementHostnameConfiguration cmdlet is a helper command that creates an instance of PsApiManagementHostnameConfiguration. This command is used with the Set-AzureRmApiManagementHostnames cmdlet.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>New-AzureRmApiManagementHostnameConfiguration</maml:name>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>CertificateThumbprint</maml:name>

          <maml:description>

            <maml:para>Specifies the certificate thumbprint. The certificate must be first imported with the Import-AzureRmApiManagementHostnameCertificate cmdlet.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>Hostname</maml:name>

          <maml:description>

            <maml:para>Specifies the custom host name for which this cmdlet creates the PsApiManagementHostnameConfiguration instance.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>CertificateThumbprint</maml:name>

        <maml:description>

          <maml:para>Specifies the certificate thumbprint. The certificate must be first imported with the Import-AzureRmApiManagementHostnameCertificate cmdlet.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>Hostname</maml:name>

        <maml:description>

          <maml:para>Specifies the custom host name for which this cmdlet creates the PsApiManagementHostnameConfiguration instance.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Create and initialize an instance of PsApiManagementHostnameConfiguration</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;New-AzureRmApiManagementHostnameConfiguration -Hostname "portal.contoso.com" -CertificateThumbprint "33CC47C6FCA848DC9B14A6F071C1EF7C"

</dev:code>

        <dev:remarks>

          <maml:para>This command creates and initializes an instance of PsApiManagementHostnameConfiguration.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Import-AzureRmApiManagementHostnameCertificate</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Set-AzureRmApiManagementHostnames</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>New-AzureRmApiManagementVirtualNetwork</command:name>

      <maml:description>

        <maml:para>Creates an instance of PsApiManagementVirtualNetwork.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>New</command:verb>

      <command:noun>AzureRmApiManagementVirtualNetwork</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The New-AzureRmApiManagementVirtualNetwork cmdlet is a helper command to create an instance of PsApiManagementVirtualNetwork. This command is used with Set-AzureRmApiManagementVirtualNetworks cmdlet.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>New-AzureRmApiManagementVirtualNetwork</maml:name>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>Location</maml:name>

          <maml:description>

            <maml:para>Specifies the location of the virtual network in which this cmdlet creates the instance.</maml:para>

            <maml:para>Valid values are:

-- North Central US

-- South Central US

-- Central US

-- West Europe

-- North Europe

-- West US

-- East US

-- East US 2

-- Japan East

-- Japan West

-- Brazil South

-- Southeast Asia

-- East Asia

-- Australia East

-- Australia Southeast</maml:para>

          </maml:description>

          <command:parameterValueGroup>

            <command:parameterValue required="true" variableLength="false">North Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">South Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">West Europe</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">North Europe</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">West US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East US 2</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Japan East</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Japan West</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Brazil South</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Southeast Asia</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East Asia</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Australia East</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Australia Southeast</command:parameterValue>

          </command:parameterValueGroup>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>SubnetName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the sub network.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>VnetId</maml:name>

          <maml:description>

            <maml:para>Specifies the identifier of the virtual network.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">Guid</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>Location</maml:name>

        <maml:description>

          <maml:para>Specifies the location of the virtual network in which this cmdlet creates the instance.</maml:para>

          <maml:para>Valid values are:

-- North Central US

-- South Central US

-- Central US

-- West Europe

-- North Europe

-- West US

-- East US

-- East US 2

-- Japan East

-- Japan West

-- Brazil South

-- Southeast Asia

-- East Asia

-- Australia East

-- Australia Southeast</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>SubnetName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the sub network.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>VnetId</maml:name>

        <maml:description>

          <maml:para>Specifies the identifier of the virtual network.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">Guid</command:parameterValue>

        <dev:type>

          <maml:name>Guid</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Create a virtual network</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;$VirtualNetworks = @()

PS C:\&gt; $VirtualNetworks += New-AzureRmApiManagementVirtualNetwork -Location "East US" -SubtenName "ContosoNet" -VnetId "089D3F4D-B986-4DFD-9259-9112BA7A1F03"

PS C:\&gt; Set-AzureRmApiManagementVirtualNetworks -ResourceGroupName "ContosoGroup" -Name "ContosoApi" -VirtualNetworks $VirtualNetworks

</dev:code>

        <dev:remarks>

          <maml:para>This example creates a virtual network and then calls the Set-AzureRmApiManagementVirtualNetworks cmdlet.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Set-AzureRmApiManagementVirtualNetworks</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>New-AzureRmApiManagement</command:name>

      <maml:description>

        <maml:para>Creates an API Management deployment.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>New</command:verb>

      <command:noun>AzureRmApiManagement</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The New-AzureRMApiManagement cmdlet creates an API Management deployment in Azure API Management.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>New-AzureRmApiManagement</maml:name>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Capacity</maml:name>

          <maml:description>

            <maml:para>Specifies the SKU capacity of the Azure API Management service. The default is one (1).</maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="true">Int32</command:parameterValue>

        </command:parameter>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Sku</maml:name>

          <maml:description>

            <maml:para>Specifies the tier of the API Management service. Valid values are:

-- Developer

-- Standard

-- Premium

The default is Developer.</maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="true">PsApiManagementSku</command:parameterValue>

        </command:parameter>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Tags</maml:name>

          <maml:description>

            <maml:para>Specifies a dictionary of tags. </maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="true">0, Culture=neutral, PublicKeyToken=b77a5c561934e089</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>AdminEmail</maml:name>

          <maml:description>

            <maml:para>Specifies the originating email address for all notifications that the API Management system sends.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Location</maml:name>

          <maml:description>

            <maml:para>Specifies the location in which this cmdlet creates an API Management deployment. To obtain valid locations, use the Get-AzureLocation cmdlets.</maml:para>

            <maml:para>Valid values are:

-- North Central US

-- South Central US

-- Central US

-- West Europe

-- North Europe

-- West US

-- East US

-- East US 2

-- Japan East

-- Japan West

-- Brazil South

-- Southeast Asia

-- East Asia

-- Australia East

-- Australia Southeast</maml:para>

          </maml:description>

          <command:parameterValueGroup>

            <command:parameterValue required="true" variableLength="false">North Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">South Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">West Europe</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">North Europe</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">West US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East US 2</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Japan East</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Japan West</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Brazil South</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Southeast Asia</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East Asia</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Australia East</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Australia Southeast</command:parameterValue>

          </command:parameterValueGroup>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Name</maml:name>

          <maml:description>

            <maml:para>Specifies a name for the API Management deployment.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Organization</maml:name>

          <maml:description>

            <maml:para>Specifies the name of an organization. API Management uses this address in the developer portal in email notifications.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>ResourceGroupName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the of resource group under which this cmdlet creates an API Management deployment.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>AdminEmail</maml:name>

        <maml:description>

          <maml:para>Specifies the originating email address for all notifications that the API Management system sends.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Capacity</maml:name>

        <maml:description>

          <maml:para>Specifies the SKU capacity of the Azure API Management service. The default is one (1).</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="true">Int32</command:parameterValue>

        <dev:type>

          <maml:name>Int32</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Location</maml:name>

        <maml:description>

          <maml:para>Specifies the location in which this cmdlet creates an API Management deployment. To obtain valid locations, use the Get-AzureLocation cmdlets.</maml:para>

          <maml:para>Valid values are:

-- North Central US

-- South Central US

-- Central US

-- West Europe

-- North Europe

-- West US

-- East US

-- East US 2

-- Japan East

-- Japan West

-- Brazil South

-- Southeast Asia

-- East Asia

-- Australia East

-- Australia Southeast</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Name</maml:name>

        <maml:description>

          <maml:para>Specifies a name for the API Management deployment.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Organization</maml:name>

        <maml:description>

          <maml:para>Specifies the name of an organization. API Management uses this address in the developer portal in email notifications.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>ResourceGroupName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the of resource group under which this cmdlet creates an API Management deployment.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Sku</maml:name>

        <maml:description>

          <maml:para>Specifies the tier of the API Management service. Valid values are:

-- Developer

-- Standard

-- Premium

The default is Developer.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="true">PsApiManagementSku</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagementSku</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Tags</maml:name>

        <maml:description>

          <maml:para>Specifies a dictionary of tags. </maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="true">0, Culture=neutral, PublicKeyToken=b77a5c561934e089</command:parameterValue>

        <dev:type>

          <maml:name>0, Culture=neutral, PublicKeyToken=b77a5c561934e089</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Create at Developer tier API Management service</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;New-AzureRmApiManagement -ResourceGroupName "ContosoGroup02" -Name "ContosoApi" -Location "Central US" -Organization "Contoso" -AdminEmail "admin@contoso.com"

</dev:code>

        <dev:remarks>

          <maml:para>This command creates a Developer tier API Management service. The command specifies the organization and the administrator address. The command does not specify the SKU parameter. Therefore, the cmdlet uses the default value of Developer.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

      <command:example>

        <maml:title>Example 2: Create a Standard tier service that has three units</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;New-AzureRmApiManagement -ResourceGroupName "ContosoGroup02 -Name "ContosoApi" -Location "Central US" -Organization "Contoso" -AdminEmail "admin@contoso.com" -Sku Standard -Capacity 3

</dev:code>

        <dev:remarks>

          <maml:para>This command creates a Standard tier API Management service that has three units.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Backup-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Get-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Remove-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Restore-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Remove-AzureRmApiManagementRegion</command:name>

      <maml:description>

        <maml:para>Removes an existing deployment region from PsApiManagement instance.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>Remove</command:verb>

      <command:noun>AzureRmApiManagementRegion</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The Remove-AzureRmApiManagementRegion cmdlet removes instance of type Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion from a collection of AdditionalRegions of provided the instance of type Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. This cmdlet does not modify deployment by itself but updates the instance of PsApiManagement in-memory. To update a deployment of an API Management, pass the modified PsApiManagementInstance to Update-AzureRmApiManagement.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Remove-AzureRmApiManagementRegion</maml:name>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByValue)" position="named" aliases="none">

          <maml:name>ApiManagement</maml:name>

          <maml:description>

            <maml:para>Specifies the PsApiManagement instance that this cmdlet removes the additional deployment region from.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">PsApiManagement</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Location</maml:name>

          <maml:description>

            <maml:para>Specifies the location of the region that this cmdlet removes.</maml:para>

            <maml:para>Valid values are:

-- North Central US

-- South Central US

-- Central US

-- West Europe

-- North Europe

-- West US

-- East US

-- East US 2

-- Japan East

-- Japan West

-- Brazil South

-- Southeast Asia

-- East Asia

-- Australia East

-- Australia Southeast</maml:para>

          </maml:description>

          <command:parameterValueGroup>

            <command:parameterValue required="true" variableLength="false">North Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">South Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">West Europe</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">North Europe</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">West US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East US 2</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Japan East</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Japan West</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Brazil South</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Southeast Asia</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East Asia</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Australia East</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Australia Southeast</command:parameterValue>

          </command:parameterValueGroup>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByValue)" position="named" aliases="none">

        <maml:name>ApiManagement</maml:name>

        <maml:description>

          <maml:para>Specifies the PsApiManagement instance that this cmdlet removes the additional deployment region from.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">PsApiManagement</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagement</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Location</maml:name>

        <maml:description>

          <maml:para>Specifies the location of the region that this cmdlet removes.</maml:para>

          <maml:para>Valid values are:

-- North Central US

-- South Central US

-- Central US

-- West Europe

-- North Europe

-- West US

-- East US

-- East US 2

-- Japan East

-- Japan West

-- Brazil South

-- Southeast Asia

-- East Asia

-- Australia East

-- Australia Southeast</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Remove a region from a PsApiManagement instance </maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Remove-AzureRmApiManagementRegion -ApiManagement $ApiManagement -Location "East US"

</dev:code>

        <dev:remarks>

          <maml:para>This command removes the region named East US from the PsApiManagement instance.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

      <command:example>

        <maml:title>Example 2: Remove a region from a PsApiManagement instance using a series of commands</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Get-AzureRmApiManagement -ResourceGroupName "Contoso" -Name ContosoApi | Remove-AzureRmApiManagementRegion -Location "East US" | Update-AzureRmApiManagementDeployment

</dev:code>

        <dev:remarks>

          <maml:para>This first command gets an instance of PsApiManagement from the resource group named Contoso named ContosoApi. The final command then removes the region named East US from that instance then updates the deployment.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Add-AzureRmApiManagementRegion</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Update-AzureRmApiManagementRegion</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Remove-AzureRmApiManagement</command:name>

      <maml:description>

        <maml:para>Removes an API Management service.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>Remove</command:verb>

      <command:noun>AzureRmApiManagement</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The Remove-AzureRmApiManagement cmdlet removes an Azure API Management service.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Remove-AzureRmApiManagement</maml:name>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>Force</maml:name>

          <maml:description>

            <maml:para>Forces the command to run without asking for user confirmation.</maml:para>

          </maml:description>

        </command:parameter>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>PassThru</maml:name>

          <maml:description>

            <maml:para>Indicates that this cmdlet returns a value of $True if the operation succeeds.</maml:para>

          </maml:description>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Name</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the API Management deployment that this cmdlet removes.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>ResourceGroupName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the of resource group under which the API Management deployment exists. </maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>Force</maml:name>

        <maml:description>

          <maml:para>Forces the command to run without asking for user confirmation.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>

        <dev:type>

          <maml:name>SwitchParameter</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Name</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the API Management deployment that this cmdlet removes.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>PassThru</maml:name>

        <maml:description>

          <maml:para>Indicates that this cmdlet returns a value of $True if the operation succeeds.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>

        <dev:type>

          <maml:name>SwitchParameter</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>ResourceGroupName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the of resource group under which the API Management deployment exists. </maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Remove an API Management service</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Remove-AzureRmApiManagement -ResourceGroupName "ContosoGroup02" -Name "ContosoApi"

</dev:code>

        <dev:remarks>

          <maml:para>This command removes the API Management service named ContosoApi.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Backup-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Get-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>New-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Restore-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Restore-AzureRmApiManagement</command:name>

      <maml:description>

        <maml:para>Restores an API Management Service from the specified Azure storage blob.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>Restore</command:verb>

      <command:noun>AzureRmApiManagement</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The Restore-AzureRmApiManagement cmdlet restores an API Management Service from the specified backup residing in an Azurestorage blob.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Restore-AzureRmApiManagement</maml:name>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="2" aliases="none">

          <maml:name>StorageContext</maml:name>

          <maml:description>

            <maml:para>Specifies the storage connection context.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">AzureStorageContext</command:parameterValue>

        </command:parameter>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>PassThru</maml:name>

          <maml:description>

            <maml:para>Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.</maml:para>

          </maml:description>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Name</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the API Management instance that this cmdlet restores.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>ResourceGroupName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of resource group under which API Management exists.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>SourceBlobName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the Azure storage backup source blob.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>SourceContainerName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the Azure storage backup source container.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Name</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the API Management instance that this cmdlet restores.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>PassThru</maml:name>

        <maml:description>

          <maml:para>Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>

        <dev:type>

          <maml:name>SwitchParameter</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>ResourceGroupName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of resource group under which API Management exists.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>SourceBlobName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the Azure storage backup source blob.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>SourceContainerName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the Azure storage backup source container.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="false" position="2" aliases="none">

        <maml:name>StorageContext</maml:name>

        <maml:description>

          <maml:para>Specifies the storage connection context.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">AzureStorageContext</command:parameterValue>

        <dev:type>

          <maml:name>AzureStorageContext</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Restore an API Management service</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Restore-AzureRmApiManagement -ResourceGroupName "ContosoGroup" -Name "RestoredContosoApi" -StorageContext $StorageContext -SourceContainerName "ContosoBackups" -SourceBlobName "ContosoBackup.apimbackup"

</dev:code>

        <dev:remarks>

          <maml:para>This command restores an API Management service from Azure storage blob.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Backup-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Get-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>New-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Remove-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Set-AzureRmApiManagementHostnames</command:name>

      <maml:description>

        <maml:para>Sets a custom hostname configuration for an API Management service proxy or portal.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>Set</command:verb>

      <command:noun>AzureRmApiManagementHostnames</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The Set-AzureRmApiManagementHostnames cmdlet applies a custom hostname configuration for an API Management service proxy or portal.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Set-AzureRmApiManagementHostnames</maml:name>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>PassThru</maml:name>

          <maml:description>

            <maml:para>Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.</maml:para>

          </maml:description>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByValue)" position="named" aliases="none">

          <maml:name>ApiManagement</maml:name>

          <maml:description>

            <maml:para>Specifies the PsApiManagement instance that this cmdlet gets the PortalHostnameConfiguration and ProxyHostnameConfiguration parameters from.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">PsApiManagement</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

      <command:syntaxItem>

        <maml:name>Set-AzureRmApiManagementHostnames</maml:name>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>PassThru</maml:name>

          <maml:description>

            <maml:para>Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.</maml:para>

          </maml:description>

        </command:parameter>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>PortalHostnameConfiguration</maml:name>

          <maml:description>

            <maml:para>Specifies the custom portal hostname configuration. Passing $null to the cmdlet sets the default hostname.</maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="false">PsApiManagementHostnameConfiguration</command:parameterValue>

        </command:parameter>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>ProxyHostnameConfiguration</maml:name>

          <maml:description>

            <maml:para>Specifies the custom proxy hostname configuration. Passing $null sets the default hostname.</maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="false">PsApiManagementHostnameConfiguration</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Name</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the API Management instance.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>ResourceGroupName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the resource group under which the API Management instance exists.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByValue)" position="named" aliases="none">

        <maml:name>ApiManagement</maml:name>

        <maml:description>

          <maml:para>Specifies the PsApiManagement instance that this cmdlet gets the PortalHostnameConfiguration and ProxyHostnameConfiguration parameters from.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">PsApiManagement</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagement</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Name</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the API Management instance.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>PassThru</maml:name>

        <maml:description>

          <maml:para>Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>

        <dev:type>

          <maml:name>SwitchParameter</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>PortalHostnameConfiguration</maml:name>

        <maml:description>

          <maml:para>Specifies the custom portal hostname configuration. Passing $null to the cmdlet sets the default hostname.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">PsApiManagementHostnameConfiguration</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagementHostnameConfiguration</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>ProxyHostnameConfiguration</maml:name>

        <maml:description>

          <maml:para>Specifies the custom proxy hostname configuration. Passing $null sets the default hostname.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">PsApiManagementHostnameConfiguration</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagementHostnameConfiguration</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>ResourceGroupName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the resource group under which the API Management instance exists.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Set the custom hostname configuration for a proxy and portal</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Set-AzureRmApiManagementHostnames -Name ContosoApi -ResourceGroupName Contoso -PortalHostnameConfiguration $portalHostnameConf -ProxyHostnameConfiguration $proxyHostnameConf

</dev:code>

        <dev:remarks>

          <maml:para>This command sets the custom hostname configuration for proxy and portal.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

      <command:example>

        <maml:title>Example 2: Configure a custom hostname for a proxy and portal</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Import-AzureRmApiManagementHostnameCertificate -Name ContosoApi -ResourceGroupName "Contoso" -HostnameType "Proxy" -PfxPath "C:\proxycert.pfx" -PfxPassword "CertSecret"

PS C:\&gt; Import-AzureRmApiManagementHostnameCertificate -Name "ContosoApi" -ResourceGroupName "Contoso" -HostnameType "Portal" -PfxPath "C:\portalcert.pfx" -PfxPassword "CertSecret"

PS C:\&gt; $PortalHostnameConf = New-AzureRmApiManagementHostnameConfiguration -Hostname "portal.contoso.com" -CertificateThumbprint "33CC47C6FCA848DC9B14A6F071C1EF7C"

PS C:\&gt; $ProxyHostnameConf = New-AzureRmApiManagementHostnameConfiguration -Hostname "proxy.contoso.com" -CertificateThumbprint "5DD7CCF6A1E74E0987DD2873406B7264"

PS C:\&gt; Set-AzureRmApiManagementHostnames -Name "ContosoApi" -ResourceGroupName "Contoso" -PortalHostnameConfiguration $PortalHostnameConf -ProxyHostnameConfiguration $ProxyHostnameConf

</dev:code>

        <dev:remarks>

          <maml:para>This example configures a custom hostname for proxy and portal. You need to import corresponding certificates and then apply the custom hostnames.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Import-AzureRmApiManagementHostnameCertificate</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>New-AzureRmApiManagementHostnameConfiguration</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Set-AzureRmApiManagementVirtualNetworks</command:name>

      <maml:description>

        <maml:para>Sets the VPN configuration for an API Management Service.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>Set</command:verb>

      <command:noun>AzureRmApiManagementVirtualNetworks</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The Set-AzureRmApiManagementVirtualNetworks cmdlet sets Virtual Network configuration for an API Management service.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Set-AzureRmApiManagementVirtualNetworks</maml:name>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>PassThru</maml:name>

          <maml:description>

            <maml:para>Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.</maml:para>

          </maml:description>

        </command:parameter>

        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>VirtualNetworks</maml:name>

          <maml:description>

            <maml:para>Specifies an array of virtual networks configurations. Passing $null will remove the virtual network configuration.</maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="true">PsApiManagementVirtualNetwork[]</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Name</maml:name>

          <maml:description>

            <maml:para>Specifies the name of an API Management service.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>ResourceGroupName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of the resource group under which the API Management service exists.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Name</maml:name>

        <maml:description>

          <maml:para>Specifies the name of an API Management service.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>PassThru</maml:name>

        <maml:description>

          <maml:para>Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>

        <dev:type>

          <maml:name>SwitchParameter</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>ResourceGroupName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of the resource group under which the API Management service exists.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>VirtualNetworks</maml:name>

        <maml:description>

          <maml:para>Specifies an array of virtual networks configurations. Passing $null will remove the virtual network configuration.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="true">PsApiManagementVirtualNetwork[]</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagementVirtualNetwork[]</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Set virtual networks for an API Management service</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Set-AzureRmApiManagementVirtualNetworks -ResourceGroupName "ContosoGroup" -Name "ContosoApi" -VirtualNetworks $VirtualNetworks

</dev:code>

        <dev:remarks>

          <maml:para>This command sets virtual networks for an API Management service.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>New-AzureRmApiManagementVirtualNetwork</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Update-AzureRmApiManagementDeployment</command:name>

      <maml:description>

        <maml:para>Updates deployment of an API Management Service.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>Update</command:verb>

      <command:noun>AzureRmApiManagementDeployment</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The Update-AzureRmApiManagementDeployment cmdlet updates current deployments of an API Management service.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Update-AzureRmApiManagementDeployment</maml:name>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>AdditionalRegions</maml:name>

          <maml:description>

            <maml:para>Specifies additional deployment regions of Azure API Management.</maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="true">0, Culture=neutral, PublicKeyToken=null</command:parameterValue>

        </command:parameter>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>PassThru</maml:name>

          <maml:description>

            <maml:para>Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.</maml:para>

          </maml:description>

        </command:parameter>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>VirtualNetwork</maml:name>

          <maml:description>

            <maml:para>Specifies the Virtual Network configuration of the master Azure API Management deployment region.</maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="false">PsApiManagementVirtualNetwork</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Capacity</maml:name>

          <maml:description>

            <maml:para>Specifies the SKU capacity of the master Azure API Management deployment region.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Location</maml:name>

          <maml:description>

            <maml:para>Specifies the location of the master API Management deployment region.</maml:para>

            <maml:para>Valid values are:

-- North Central US

-- South Central US

-- Central US

-- West Europe

-- North Europe

-- West US

-- East US

-- East US 2

-- Japan East

-- Japan West

-- Brazil South

-- Southeast Asia

-- East Asia

-- Australia East

-- Australia Southeast</maml:para>

          </maml:description>

          <command:parameterValueGroup>

            <command:parameterValue required="true" variableLength="false">North Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">South Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">West Europe</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">North Europe</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">West US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East US 2</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Japan East</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Japan West</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Brazil South</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Southeast Asia</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East Asia</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Australia East</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Australia Southeast</command:parameterValue>

          </command:parameterValueGroup>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Name</maml:name>

          <maml:description>

            <maml:para>Specifies the name of API Management that this cmdlet updates.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>ResourceGroupName</maml:name>

          <maml:description>

            <maml:para>Specifies the name of resource group under which API Management exists.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Sku</maml:name>

          <maml:description>

            <maml:para>Specifies the tier of the master Azure API Management deployment region.</maml:para>

            <maml:para>Valid values are:

-- Developer

-- Standard

-- Premium</maml:para>

          </maml:description>

          <command:parameterValueGroup>

            <command:parameterValue required="true" variableLength="false">Developer</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Standard</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Premium</command:parameterValue>

          </command:parameterValueGroup>

        </command:parameter>

      </command:syntaxItem>

      <command:syntaxItem>

        <maml:name>Update-AzureRmApiManagementDeployment</maml:name>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

          <maml:name>PassThru</maml:name>

          <maml:description>

            <maml:para>Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.</maml:para>

          </maml:description>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByValue)" position="named" aliases="none">

          <maml:name>ApiManagement</maml:name>

          <maml:description>

            <maml:para>Specifies the PsApiManagement instance to get deployment configuration from. Use this parameter if the instance already has all the required changes.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">PsApiManagement</command:parameterValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>AdditionalRegions</maml:name>

        <maml:description>

          <maml:para>Specifies additional deployment regions of Azure API Management.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="true">0, Culture=neutral, PublicKeyToken=null</command:parameterValue>

        <dev:type>

          <maml:name>0, Culture=neutral, PublicKeyToken=null</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByValue)" position="named" aliases="none">

        <maml:name>ApiManagement</maml:name>

        <maml:description>

          <maml:para>Specifies the PsApiManagement instance to get deployment configuration from. Use this parameter if the instance already has all the required changes.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">PsApiManagement</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagement</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Capacity</maml:name>

        <maml:description>

          <maml:para>Specifies the SKU capacity of the master Azure API Management deployment region.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue>

        <dev:type>

          <maml:name>Int32</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Location</maml:name>

        <maml:description>

          <maml:para>Specifies the location of the master API Management deployment region.</maml:para>

          <maml:para>Valid values are:

-- North Central US

-- South Central US

-- Central US

-- West Europe

-- North Europe

-- West US

-- East US

-- East US 2

-- Japan East

-- Japan West

-- Brazil South

-- Southeast Asia

-- East Asia

-- Australia East

-- Australia Southeast</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Name</maml:name>

        <maml:description>

          <maml:para>Specifies the name of API Management that this cmdlet updates.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases="none">

        <maml:name>PassThru</maml:name>

        <maml:description>

          <maml:para>Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>

        <dev:type>

          <maml:name>SwitchParameter</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>ResourceGroupName</maml:name>

        <maml:description>

          <maml:para>Specifies the name of resource group under which API Management exists.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Sku</maml:name>

        <maml:description>

          <maml:para>Specifies the tier of the master Azure API Management deployment region.</maml:para>

          <maml:para>Valid values are:

-- Developer

-- Standard

-- Premium</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">PsApiManagementSku</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagementSku</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>VirtualNetwork</maml:name>

        <maml:description>

          <maml:para>Specifies the Virtual Network configuration of the master Azure API Management deployment region.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">PsApiManagementVirtualNetwork</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagementVirtualNetwork</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title>Example 1: Update a deployment of an ApiManagement instance</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;Update-AzureRmApiManagementDeployment -ResourceGroupName "Contoso" -Name "ContosoApi" -Sku "Standard" -Capacity 3

</dev:code>

        <dev:remarks>

          <maml:para>This command updates deployment of an API Management instance to a three unit capacity standard.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

      <command:example>

        <maml:title>Example 2: Get an ApiManagement instance and rescale it</maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:code>PS C:\&gt;$ApiManagement = Get-AzureRmApiManagement -ResourceGroupName "Contoso" -Name "ContosoApi"

PS C:\&gt; $ApiManagement.Sku = "Premium"

PS C:\&gt; $ApiManagement.Capacity = 5

PS C:\&gt; $ApiManagement.AddRegion("Central US", "Premium", 3)

PS C:\&gt; Update-AzureRmApiManagementDeployment -ApiManagement $ApiManagement

</dev:code>

        <dev:remarks>

          <maml:para>This example gets an Api Management instance, scales it to five premium units and then adds an additional three units to the premium region.</maml:para>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Get-AzureRmApiManagement</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Update-AzureRmApiManagementRegion</command:name>

      <maml:description>

        <maml:para>Updates existing deployment region in PsApiManagement instance.</maml:para>

      </maml:description>

      <maml:copyright>

        <maml:para />

      </maml:copyright>

      <command:verb>Update</command:verb>

      <command:noun>AzureRmApiManagementRegion</command:noun>

      <dev:version />

    </command:details>

    <maml:description>

      <maml:para>The Update-AzureRmApiManagementRegion cmdlet updates an existing instance of type Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion in a collection of AdditionalRegions objects of a provided instance of type Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. This cmdlet does not deploy anything but updates an instance of PsApiManagement in-memory. To update a deployment of an API Management use the modified PsApiManagementInstance to the Update-AzureRmApiManagementDeployment cmdlet.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Update-AzureRmApiManagementRegion</maml:name>

        <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>VirtualNetwork</maml:name>

          <maml:description>

            <maml:para>Specifies a virtual network configuration for the deployment region. Passing $null will remove virtual network configuration for the region.</maml:para>

          </maml:description>

          <command:parameterValue required="false" variableLength="false">PsApiManagementVirtualNetwork</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByValue)" position="named" aliases="none">

          <maml:name>ApiManagement</maml:name>

          <maml:description>

            <maml:para>Specifies the PsApiManagement instance to update an existing deployment region in.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">PsApiManagement</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Capacity</maml:name>

          <maml:description>

            <maml:para>Specifies the new SKU capacity value for the deployment region.</maml:para>

          </maml:description>

          <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Location</maml:name>

          <maml:description>

            <maml:para>Specifies the location of the deployment region to update.</maml:para>

            <maml:para>Valid values are:

-- North Central US

-- South Central US

-- Central US

-- West Europe

-- North Europe

-- West US

-- East US

-- East US 2

-- Japan East

-- Japan West

-- Brazil South

-- Southeast Asia

-- East Asia

-- Australia East

-- Australia Southeast</maml:para>

          </maml:description>

          <command:parameterValueGroup>

            <command:parameterValue required="true" variableLength="false">North Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">South Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Central US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">West Europe</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">North Europe</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">West US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East US</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East US 2</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Japan East</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Japan West</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Brazil South</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Southeast Asia</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">East Asia</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Australia East</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Australia Southeast</command:parameterValue>

          </command:parameterValueGroup>

        </command:parameter>

        <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

          <maml:name>Sku</maml:name>

          <maml:description>

            <maml:para>Specifies the new tier value for the deployment region.</maml:para>

            <maml:para>Valid values are:

-- Developer

-- Standard

-- Premium</maml:para>

          </maml:description>

          <command:parameterValueGroup>

            <command:parameterValue required="true" variableLength="false">Developer</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Standard</command:parameterValue>

            <command:parameterValue required="true" variableLength="false">Premium</command:parameterValue>

          </command:parameterValueGroup>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByValue)" position="named" aliases="none">

        <maml:name>ApiManagement</maml:name>

        <maml:description>

          <maml:para>Specifies the PsApiManagement instance to update an existing deployment region in.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">PsApiManagement</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagement</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Capacity</maml:name>

        <maml:description>

          <maml:para>Specifies the new SKU capacity value for the deployment region.</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue>

        <dev:type>

          <maml:name>Int32</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Location</maml:name>

        <maml:description>

          <maml:para>Specifies the location of the deployment region to update.</maml:para>

          <maml:para>Valid values are:

-- North Central US

-- South Central US

-- Central US

-- West Europe

-- North Europe

-- West US

-- East US

-- East US 2

-- Japan East

-- Japan West

-- Brazil South

-- Southeast Asia

-- East Asia

-- Australia East

-- Australia Southeast</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>

        <dev:type>

          <maml:name>String</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="true" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>Sku</maml:name>

        <maml:description>

          <maml:para>Specifies the new tier value for the deployment region.</maml:para>

          <maml:para>Valid values are:

-- Developer

-- Standard

-- Premium</maml:para>

        </maml:description>

        <command:parameterValue required="true" variableLength="false">PsApiManagementSku</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagementSku</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

      <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="true(ByPropertyName)" position="named" aliases="none">

        <maml:name>VirtualNetwork</maml:name>

        <maml:description>

          <maml:para>Specifies a virtual network configuration for the deployment region. Passing $null will remove virtual network configuration for the region.</maml:para>

        </maml:description>

        <command:parameterValue required="false" variableLength="false">PsApiManagementVirtualNetwork</command:parameterValue>

        <dev:type>

          <maml:name>PsApiManagementVirtualNetwork</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>none</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>

          </maml:name>

          <maml:uri>

          </maml:uri>

          <maml:description>

            <maml:para />

          </maml:description>

        </dev:type>

        <maml:description>

          <maml:para>

          </maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <command:terminatingErrors />

    <command:nonTerminatingErrors />

    <command:examples>

      <command:example>

        <maml:title> 1: </maml:title>

        <maml:introduction>

          <maml:para>

          </maml:para>

        </maml:introduction>

        <dev:remarks>

          <maml:para />

          <maml:para />

        </dev:remarks>

        <command:commandLines>

          <command:commandLine>

            <command:commandText />

          </command:commandLine>

        </command:commandLines>

      </command:example>

    </command:examples>

    <maml:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Add-AzureRmApiManagementRegion</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Remove-AzureRmApiManagementRegion</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

      <maml:navigationLink>

        <maml:linkText>Update-AzureRmApiManagementDeployment</maml:linkText>

        <maml:uri />

      </maml:navigationLink>

    </maml:relatedLinks>

  </command:command>

</helpItems>