Broker PowerCLI Commands

The View PowerCLI cmdlets which are to perform various administration tasks on Connection Server and Windows desktop, can also work for Linux desktop.

Create a Manual Desktop Pool

Add-ManualPool -DefaultProtocol Blast -AllowProtocolOverride $false -threedRender usevc|vgpu  -Pool_id <pool id> [more parameters]

For Linux Desktop the following options and values are mandatory.

• DefaultProtocol Blast
• AllowProtocolOverride $false
• threedRender usevc|vgpu. For vGPU desktop, use -threedRender vgpu and for 2D/vSGA/vDGA desktop -threedRender usevc .

Examples

• Create a floating Linux Desktop pool named LinuxDesktop with a virtual machine, LinuxVM-01.

  Add-ManualPool -DefaultProtocol Blast -AllowProtocolOverride $false -threedRender usevc -Pool_id LinuxDesktop -Id (Get-DesktopVM -Name LinuxVM-01).id -Persistence NonPersistent -Vc_name myvc.myorg.org

• Create a dedicated Linux vGPU desktop pool named LinuxDesktop with all VMs that start with VM name as LinuxVM-.

  Get-DesktopVM | Where-Object {$_.Name.StartsWith("LinuxVM-")} | Add-ManualPool -DefaultProtocol Blast -AllowProtocolOverride $false -Persistence Persistent -threedRender vgpu  -Pool_id LinuxDesktop 

• Create floating Linux desktop pool LinuxDesktop with the first RHEL 6 x64 VM.

  Get-DesktopVM | Where-Object {$_.GuestID -eq "rhel6_64Guest"} | Select-Object -Index 0  | Add-ManualPool -DefaultProtocol Blast -AllowProtocolOverride $false -Persistence NonPersistent -threedRender usevc -Pool_id LinuxDesktop

Create a Full-Clone Automated Desktop Pool

Add-AutomaticPool -DefaultProtocol Blast -AllowProtocolOverride $false -threedRender usevc|vgpu `
-Pool_id <pool id> -Vc_id <vCenter id> `
-NamePrefix <VM Name Prefix>" `
-templatePath <Virtual Machine Template Path> `
-VmFolderPath <Virtual Machine Folder Path> `
-ResourcePoolPath <Resource Pool Path> `
-dataStorePaths <Datastore Path> `
-customizationSpecName <Customization Specification Name> `
 [more parameters]

For Linux Desktop the following options and values are mandatory.

• DefaultProtocol Blast
• AllowProtocolOverride $false
• threedRender usevc|vgpu. For vGPU desktop, use -threedRender vgpu and for 2D/vSGA desktop -threedRender usevc.

Example

Add-AutomaticPool -DefaultProtocol Blast -AllowProtocolOverride $false -threedrender usevc`
-pool_id FullClone-Linux `
-Vc_id (Get-ViewVC -serverName myvc.myorg.org).vc_id   `
-NamePrefix "FullClone-{n:fixed=3}" `
-Persistence NonPersistent –deletePolicy DeleteOnUse `
-VmFolderPath "/LinuxVDI/vm/FullClone" `
-ResourcePoolPath "/LinuxVDI/host/LinuxVDICluster/Resources" `
-templatePath "/LinuxVDI/vm/LinuxTemplate" `
-dataStorePaths "/LinuxVDI/host/LinuxVDICluster/datastore" `
-customizationSpecName "linux-spec" `
-maximumCount 100

Add or Remove Desktop Pool Entitlement

• Entitle domain user group of domain mydomain.org to LinuxDesktop.

  Add-PoolEntitlement -Pool_id LinuxDesktop -Sid (Get-User -Name "domain user" -Domain "mydomain.org").sid

• Remove entitlement of domain user group of mydomain.org domain from LinuxDesktop.

  Remove-PoolEntitlement -Pool_id LinuxDesktop -Sid (Get-User -Name "domain user" -Domain "mydomain.org").sid

Assign or Remove User To or From the VM in Dedicated Desktop Pool

• Assign myuser user to LinuxVM-01 VM which is in a dedicated desktop pool.

  Update-UserOwnership -Machine_id (Get-DesktopVM -Name "LinuxVM-01").machine_id -Sid (Get-User -Name "myuser" | Where-Object {$_.cn -eq "myuser"}).sid

• Remove myuser user from LinuxVM-01 VM which is in a dedicated desktop pool.

  Remove-UserOwnership -Machine_id (Get-DesktopVM -Name "LinuxVM-01").machine_id

Logoff Desktop Connection

• Logoff from the desktop session of myuser.

  Get-RemoteSession -Username "mydomain.org\myuser" | Send-SessionLogoff

For more information on broker PowerCLI cmdlet, see Using View PowerCLI in View Integration.