New-CsGroupPickupUserOrbit

Use the New-CsGroupPickupUserOrbit cmdlet to assign and enable a group pickup orbit number for an Enterprise Voice user.

Syntax

New-CsGroupPickupUserOrbit
   [-User] <String>
   -Orbit <String>
   [-Confirm]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Description

The same orbit can be assigned to multiple users. This cmdlet will throw an exception if the user is already assigned a group pickup orbit number, or if the specified orbit does not exist or is of the wrong type.

Examples

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

New-CsGroupPickupUserOrbit -User sip:KenMyers@Contoso.com -Orbit "*100"

This example adds a user specified by the SIP address to the *100 orbit.

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

New-CsGroupPickupUserOrbit "Ken Myers" -Orbit 2103

This example adds a user specified by display name to the 2103 orbit. Because User is a positional parameter, the -User syntax is not required. The first parameter after the cmdlet is assumed to be the User parameter value.

Required Parameters

-Orbit

Specifies the group pickup orbit number to be assigned to the user. The number must be within an orbit pickup range that was created with a type of GroupPickup. For more information on creating call park orbits, see New-CsCallParkOrbit (https://technet.microsoft.com/en-us/library/gg398936.aspx).

Values for the Orbit parameter must match the regular expression ([*|#]?[1-9]\d{0,7})|([1-9]\d{0,8}).

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015
-User

Specifies the user whose group pickup orbit number will be assigned. Because User is a positional parameter, the -User syntax is not required. The first parameter after the cmdlet is assumed to be the User parameter value.

Users can be specified using one of four formats: 1) the user's SIP address; 2) the user's user principal name (UPN); 3) the user's domain name and logon name, in the form domain\logon (for example, litwareinc\kenmyer); and, 4) the user's Active Directory display name (for example, Ken Myer). You can also reference a user account by using the user's Active Directory distinguished name.

Type:String
Aliases:DisplayName, SipAddress, Identity
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
Applies to:Skype for Business Server 2015

Optional Parameters

-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015
-Force

Suppresses the display of any non-fatal error messages and completes the cmdlet operation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015
-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015

Inputs

This cmdlet supports pipelined input from the Get-CsUser cmdlet.

Outputs

This cmdlet returns an instance of the Microsoft.Rtc.Management.Voice.Helpers.GroupPickup.DisplayGroupPickupUserOrbit object.