Move-CrmRecordToQueue

NAME Move-CrmRecordToQueue



SYNOPSIS

Move a CRM record to a Queue





SYNTAX

Move-CrmRecordToQueue [-conn <CrmServiceClient>] [-CrmRecord] <PSObject> [-QueueName] <String> [-WorkingUserId]

<Guid> [[-SetWorkingByUser] <Boolean>] [<CommonParameters>]



Move-CrmRecordToQueue [-conn <CrmServiceClient>] [-EntityLogicalName] <String> [-Id] <Guid> [-QueueName] <String>

[-WorkingUserId] <Guid> [[-SetWorkingByUser] <Boolean>] [<CommonParameters>]





DESCRIPTION

The Move-CrmRecordToQueue cmdlet lets you move a record to a queue.



There are two ways to specify a record.

1. Pass EntityLogicalName and record's Id.

2. Get a record object by using Get-CrmRecord/Get-CrmRecords cmdlets, then pass it.





PARAMETERS

-conn <CrmServiceClient>

A connection to your CRM organization. Use $conn = Get-CrmConnection <Parameters> to generate it.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-CrmRecord <PSObject>

A record object which is obtained via Get-CrmRecord/Get-CrmRecords. When you pass CrmRecord, then you don't

use EntityLogicalName/Id.



Required? true

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



-QueueName <String>

Queue's Name to move the record.



Required? true

Position? 3

Default value

Accept pipeline input? false

Accept wildcard characters? false



-WorkingUserId <Guid>

An Id (guid) of SystemUser who works on the queue item.



Required? true

Position? 4

Default value

Accept pipeline input? false

Accept wildcard characters? false



-SetWorkingByUser [<Boolean>]

Specify if the record needs to be marked as WorkingByUser.



Required? false

Position? 5

Default value

Accept pipeline input? false

Accept wildcard characters? false



-EntityLogicalName <String>

A logicalname for an Entity to move. i.e.)accout, contact, lead, etc..



Required? true

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Id <Guid>

An Id (guid) of the record



Required? true

Position? 2

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS









OUTPUTS









NOTES









-------------------------- Example 1 --------------------------



Move-CrmRecordToQueue -conn $conn -EntityLogicalName incident -Id 1e005a70-6317-e511-80da-c4346bc43d94 -QueueName

"Support Queue" -WorkingUserId f9d40920-7a43-4f51-9749-0549c4caf67d



This example moves an incident (Case) record to "Support Queue" queue and assigned it to a User as WorkingUser.







-------------------------- Example 2 --------------------------



Move-CrmRecordToQueue incident 1e005a70-6317-e511-80da-c4346bc43d94 "Support Queue"

f9d40920-7a43-4f51-9749-0549c4caf67d $True



This example moves an incident (Case) record to "Support Queue" queue and assigned it to a User as WorkingUser and

mark it as User Working

When omitting parameter names, you do not provide $conn, cmdlets automatically finds it.







-------------------------- Example 3 --------------------------



PS C:\\>$incident = Get-CrmRecord incident 20005a70-6317-e511-80da-c4346bc43d94 title



PS C:\\>Move-CrmRecordToQueue $incident "Support Queue" f9d40920-7a43-4f51-9749-0549c4caf67d $True



This example retrieves and store an incident record, then pass it to Move-CrmRecordToQueue.









RELATED LINKS