Citrix Virtual Apps and Desktops SDK

New-BrokerMachine

Adds a machine that can be used to run desktops and applications.

Syntax

New-BrokerMachine
   [-AssignedClientName <String>]
   [-AssignedIPAddress <String>]
   -CatalogUid <Int32>
   [-HostedMachineId <String>]
   [-HypervisorConnectionUid <Int32>]
   [-InMaintenanceMode <Boolean>]
   [-IsReserved <Boolean>]
   [-MachineName] <String>
   [-UUID <Guid>]
   [-LoggingId <Guid>]
   [<CitrixCommonParameters>]
   [<CommonParameters>]
<!--NeedCopy-->

Description

By adding a machine to a catalog, New-BrokerMachine adds a machine to the site, and is the first step in making the machine available to run users’ desktops and applications. The machine may be physical or virtual.

For physical machines, you must specify the machine’s SID and the catalog to which it will belong. For virtual machines which are not provisioned by MCS, you must also provide the hypervisor connection responsible for running the machine and the hosted machine ID by which the hypervisor recognizes the machine.

The machine must support the expected capabilities of the catalog: the catalog specifies a SessionType and a MinimalFunctionalLevel. The session support of the machine is determined by the type of Citrix VDA software installed (server or workstation) and the functional level depends on the version of the Citrix VDA software installed. The New-BrokerMachine command will complete successfully if these are not correct but the machine will be unable to register.

For more information about machines, see about_Broker_Machines.

Examples

EXAMPLE 1

This adds the physical machine with the specified SAM name to this site and places it in the specified catalog.

New-BrokerMachine -CatalogUid 2 -MachineName 'domain\machine'
<!--NeedCopy-->

EXAMPLE 2

This adds the physical machine with the specified SID to this site and places it in the specified catalog.

New-BrokerMachine -CatalogUid 2 -MachineName 'S-1-5-12-1234567890-1234567890-1234567890-1234'
<!--NeedCopy-->

EXAMPLE 3

This adds the virtual machine, running on the specified hypervisor, to this site and places it in the catalog.

New-BrokerMachine -CatalogUid 2 -MachineName 'domain\machine' -HostedMachineId 'F8143B4F-7371-4efa-868A-54787EF9F64E' -HypervisorConnectionUid 5
<!--NeedCopy-->

EXAMPLE 4

This adds the specified physical machine to the site and uses Add-BrokerMachine to add it to a desktop group.

$m = New-BrokerMachine -CatalogUid 2 -MachineName 'domain\machine'
Add-BrokerMachine -InputObject $m -DesktopGroup 3
<!--NeedCopy-->

Parameters

-MachineName

Specify the name of the machine to create (in the form ‘domain\machine’). A SID can also be specified.

Type: String
Position: 2
Default value: None
Required: True
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: True

-CatalogUid

The catalog to which this machine will belong.

Type: Int32
Position: Named
Default value: None
Required: True
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-AssignedClientName

The client name to which this machine will be assigned. Machines can be assigned to multiple users, a single client IP address, or a single client name, but only to one of these categories at a time.

Type: String
Position: Named
Default value: None
Required: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: True

-AssignedIPAddress

The client IP address to which this machine will be assigned. Machines can be assigned to multiple users, a single client IP address, or a single client name, but only to one of these categories at a time.

Type: String
Position: Named
Default value: None
Required: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: True

-HostedMachineId

The unique ID by which the hypervisor recognizes the machine. Omit this for physical machines or MCS-provisioned VMs.

Type: String
Position: Named
Default value: None
Required: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: True

-HypervisorConnectionUid

The hypervisor connection that runs the machine. Omit this for physical machines or MCS-provisioned VMs.

Type: Int32
Position: Named
Default value: None
Required: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-InMaintenanceMode

Specifies whether the machine is initially in maintenance mode. A machine in maintenance mode is not available for new sessions, and for managed machines all automatic power management is disabled.

Type: Boolean
Position: Named
Default value: False
Required: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-IsReserved

Specifies whether the machine should be reserved for special use. A reserved machine cannot be added to a desktop group.

Type: Boolean
Position: Named
Default value: None
Required: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-UUID

An optional GUID for this machine.

Type: Guid
Position: Named
Default value: A new GUID is generated if none is supplied.
Required: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-LoggingId

Specifies the identifier of the high level operation that this cmdlet call forms a part of. Desktop Studio and Desktop Director typically create High Level Operations. PowerShell scripts can also wrap a series of cmdlet calls in a High Level Operation by way of the Start-LogHighLevelOperation and Stop-LogHighLevelOperation cmdlets.

Type: Guid
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

CitrixCommonParameters

This cmdlet supports the common Citrix parameters: -AdminAddress, -AdminClientIP, -BearerToken, -TraceParent, -TraceState and -VirtualSiteId. For more information, see about_CitrixCommonParameters.

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

You cannot pipe input into this cmdlet.

Outputs

Citrix.Broker.Admin.SDK.Machine

New-BrokerMachine returns the created machine.

New-BrokerMachine