Skip to content

Latest commit

 

History

History
114 lines (87 loc) · 4.2 KB

remoteapp-tutorial-arawithpowershell.md

File metadata and controls

114 lines (87 loc) · 4.2 KB
title description services documentationcenter author manager editor ms.assetid ms.service ms.devlang ms.topic ms.tgt_pltfrm ms.workload ms.date ms.author
Use PowerShell cmdlets with Azure RemoteApp | Microsoft Docs
Learn how to use Windows PowerShell cmdlets in Azure RemoteApp.
remoteapp
guscatalano
mbaldwin
7d3d5ded-6f73-4de6-a8ac-c1d622e842a2
remoteapp
na
article
na
compute
11/23/2016
mbaldwin

Use Windows PowerShell cmdlets with Azure RemoteApp

Important

Azure RemoteApp is being discontinued. Read the announcement for details.

You can use the Azure RemoteApp PowerShell cmdlets to administer and maintain your collections. Use the following information to get started.

Get the cmdlets

First download the Azure Powershell cmdlets here, the RemoteApp cmdlets are included in it.

Check out the Azure RemoteApp cmdlet help.

Configure Azure cmdlets to use your subscription

Follow this guide so you can use the cmdlets against your Azure subscription.

You can use these steps to get started quickly:

  1. Download and install the Azure PowerShell cmdlets.
  2. Launch Microsoft Azure PowerShell.
  3. Run Add-AzureAccount to authenticate to your Azure subscription. When prompted, enter the same user name and password that you use to sign in to Azure portal.
  4. Run Get-AzureSubscription to list the subscriptions associated with your user account.
  5. Run Select-AzureSubscription and specify the subscription name or ID to use in the PowerShell console.

Congratulations, your Azure PowerShell console is configured and ready to use. Be aware that you'll need to repeate steps 2 through 5 each time you start the the Azure PowerShell console.

Create a cloud collection

It's simple, run the following command:

New-AzureRemoteAppCollection -Collectionname RAppO365Col1 -ImageName "Office 365 ProPlus (Subscription required)" -Plan Basic -Location "West US" - Description "Office 365 Collection."

The above command automatically publishes Microsoft Office 365 applications (Excel, OneNote, Outlook, PowerPoint, Visio and Word).

Collection creation can take 30 minutes or longer to complete. Therefore, this command returns a tracking ID that you can use as follows:

Get-AzureRemoteAppOperationResult -TrackingId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

After the collection is done, you can add users to the collection with the following command:

Add-AzureRemoteAppUser -CollectionName RAppO365Col1 -Type microsoftAccount -UserUpn [email protected]

And you're done! That user should be able to connect to the application using the Azure RemoteApp client found here.

Available cmdlets

There are lots of other commands that we have, the documentation for them will be coming shortly:

Basic RemoteApp Collection cmdlets:

  • New-AzureRemoteAppCollection
  • Get-AzureRemoteAppCollection
  • Set-AzureRemoteAppCollection
  • Update-AzureRemoteAppCollection
  • Remove-AzureRemoteAppCollection
  • Add-AzureRemoteAppUser
  • Get-AzureRemoteAppUser
  • Remove-AzureRemoteAppUser
  • Get-AzureRemoteAppSession
  • Disconnect-AzureRemoteAppSession
  • Invoke-AzureRemoteAppSessionLogoff
  • Send-AzureRemoteAppSessionMessage
  • Get-AzureRemoteAppProgram
  • Get-AzureRemoteAppStartMenuProgram
  • Publish-AzureRemoteAppProgram
  • Unpublish-AzureRemoteAppProgram
  • Get-AzureRemoteAppCollectionUsageDetails
  • Get-AzureRemoteAppCollectionUsageSummary
  • Get-AzureRemoteAppPlan

RemoteApp virtual network cmdlets:

  • New-AzureRemoteAppVNet
  • Get-AzureRemoteAppVNet
  • Set-AzureRemoteAppVNet
  • Remove-AzureRemoteAppVNet
  • Get-AzureRemoteAppVpnDevice
  • Get-- AzureRemoteAppVpnDeviceConfigScript
  • Reset-AzureRemoteAppVpnSharedKey

RemoteApp template image cmdlets:

  • New-AzureRemoteAppTemplateImage
  • Get-AzureRemoteAppTemplateImage
  • Rename-AzureRemoteAppTemplateImage
  • Remove-AzureRemoteAppTemplateImage

Other RemoteApp cmdlets:

  • Get-AzureRemoteAppLocation
  • Get-AzureRemoteAppWorkspace
  • Set-AzureRemoteAppWorkspace
  • Get-AzureRemoteAppOperationResult