Get-CsOnlineVoiceUser

Use the Get-CsOnlineVoiceUser cmdlet to retrieve a voice user's telephone number and location.

Syntax

Get-CsOnlineVoiceUser
   [-CivicAddressId <XdsCivicAddressId>]
   [-DomainController <Fqdn>]
   [-EnterpriseVoiceStatus <MultiValuedProperty>]
   [-ExpandLocation]
   [-First <Unlimited>]
   [-Force]
   [-GetFromAAD]
   [-GetPendingUsers]
   [-Identity <UserIdParameter>]
   [-LocationId <LocationID>]
   [-NumberAssigned]
   [-NumberNotAssigned]
   [-PSTNConnectivity <MultiValuedProperty>]
   [-SearchQuery <String>]
   [-Skip <Unlimited>]
   [-Tenant <Guid>]
   [<CommonParameters>]

Description

In Teams PowerShell Module version 3.0 and later, the following improvements have been introduced for organizations using Teams:

  • This cmdlet now accurately returns users who are voice-enabled (the older cmdlet in version 2.6.0 and earlier returned users without MCOEV* plans assigned).
  • The result size is not limited to 100 users anymore (the older cmdlet in version 2.6.0 and earlier limited the result size to 100).

In Teams PowerShell Module version 2.6.2 and later, the following attributes are deprecated for organizations with Teams users using the ExpandLocation parameter:

  • Force
  • NumberOfResultsToSkip
  • CorrelationId
  • Verb
  • ResultSize
  • LicenceState

In Teams PowerShell Module version 2.6.2 and later, the following input parameters are deprecated for organizations with Teams users due to low or zero usage:

  • DomainController
  • Force
  • GetFromAAD
  • GetPendingUsers
  • SearchQuery
  • Skip
  • Tenant
  • Common Parameters

Examples

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

PS C:\> Get-CsOnlineVoiceUser -Identity Ken.Myer@contoso.com

This example uses the User Principal Name (UPN) to retrieve the location and phone number information.

Parameters

-CivicAddressId

Specifies the identity of the civic address that is assigned to the target users.

Type:XdsCivicAddressId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-DomainController

This parameter is reserved for internal Microsoft use.

Type:Fqdn
Aliases:DC
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-EnterpriseVoiceStatus

Possible values are:

  • All
  • Enabled
  • Disabled
Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-ExpandLocation

Displays the location parameter with its value.

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

Specifies the number of users to return. The default is 100.

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Force

This parameter has been deprecated from Teams PowerShell Modules 3.0 and above due to limited usage.

The Force switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the Force switch isn't provided in the command, you're prompted for administrative input if required.

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

This parameter has been deprecated from Teams PowerShell Modules 3.0 and above due to limited usage.

Use this switch to get the users from Azure Active Directory.

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

This parameter has been deprecated from Teams PowerShell Modules 3.0 and above due to limited usage.

Use this switch to get only the users in pending state.

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

Specifies the identity of the target user. Acceptable values include:

Example: jphillips@contoso.com

Example: sip:jphillips@contoso.com

Example: 98403f08-577c-46dd-851a-f0460a13b03d

Type:UserIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-LocationId

Specifies the location identity of the location whose users will be returned. You can find location identifiers by using the Get-CsOnlineLisLocation cmdlet.

Type:LocationID
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-NumberAssigned

If specified, the query will return users who have a phone number assigned.

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

If specified, the query will return users who do not have a phone number assigned.

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

Possible values are:

  • All
  • Online
  • OnPremises
Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-SearchQuery

This parameter has been deprecated from Teams PowerShell Modules 3.0 and above due to limited usage.

The SearchQuery parameter specifies a search string or a query formatted using Keyword Query Language (KQL). For more details about KQL, see Keyword Query Language syntax reference (https://go.microsoft.com/fwlink/p/?linkid=269603).

If this parameter is empty, all users are returned.

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

Specifies the number of users to skip. If you used the First parameter to return the first 50 users and wanted to get another 50, you could use -Skip 50 to avoid returning the first 50 you've already reviewed. The default is 0.

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Tenant

This parameter has been deprecated from Teams PowerShell Modules 3.0 and above due to limited usage.

This parameter is reserved for internal Microsoft use.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online

Inputs

None

Outputs

Deserialized.Microsoft.Rtc.Management.Hosted.Bvd.Types.LacUser