Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
New-CsTeamsIPPhonePolicy
- Module:
- MicrosoftTeams PowerShell module
New-CsTeamsIPPhonePolicy allows you to create a policy to manage features related to Teams phone experiences. Teams phone policies determine the features that are available to users.
Syntax
Default (Default)
New-CsTeamsIPPhonePolicy
[[-Identity] <XdsIdentity>]
[-AllowBetterTogether <String>]
[-AllowHomeScreen <String>]
[-AllowHotDesking <Boolean>]
[-Confirm]
[-Description <String>]
[-Force]
[-HotDeskingIdleTimeoutInMinutes <Int>]
[-InMemory]
[-SearchOnCommonAreaPhoneMode <Object>]
[-SignInMode <String>]
[-Tenant <Guid>]
[-WhatIf]
[<CommonParameters>]
Description
The New-CsTeamsIPPhonePolicy cmdlet allows you to create a policy to manage features related to Teams phone experiences assigned to a user account used to sign into a Teams phone.
Examples
Example 1
PS C:\> New-CsTeamsIPPhonePolicy -Identity CommonAreaPhone -SignInMode CommonAreaPhoneSignin
This example shows a new policy being created called "CommonAreaPhone" setting the SignInMode as "CommonAreaPhoneSignIn".
Parameters
-AllowBetterTogether
Determines whether Better Together mode is enabled, phones can lock and unlock in an integrated fashion when connected to their Windows PC running a 64-bit Teams desktop client. Possible values this parameter can take:
- Enabled
- Disabled
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowHomeScreen
Determines whether the Home Screen feature of the Teams IP Phones is enabled. Possible values this parameter can take:
- Enabled
- EnabledUserOverride
- Disabled
Parameter properties
| Type: | String |
| Default value: | EnabledUserOverride |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowHotDesking
Determines whether hot desking mode is enabled. Set this to TRUE to enable. Set this to FALSE to disable hot desking mode.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
-Description
Free form text that can be used by administrators as desired.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Force
Suppresses any confirmation prompts that would otherwise be displayed before making changes and suppresses the display of any non-fatal error message that might arise when running the command.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-HotDeskingIdleTimeoutInMinutes
Determines the idle timeout value in minutes for the signed in user account. When the timeout is reached, the account is logged out.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Identity
The identity of the policy that you want to create.
Parameter properties
| Type: | XdsIdentity |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-SearchOnCommonAreaPhoneMode
Determines whether a user can search the Global Address List in Common Area Phone Mode. Set this to ENABLED to enable the feature. Set this to DISABLED to disable the feature.
Parameter properties
| Type: | Object |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-SignInMode
Determines the sign in mode for the device when signing in to Teams. Possible Values:
- 'UserSignIn: Enables the individual user's Teams experience on the phone'
- 'CommonAreaPhoneSignIn: Enables a Common Area Phone experience on the phone'
- 'MeetingSignIn: Enables the meeting/conference room experience on the phone'
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Tenant
Internal Microsoft use only.
Parameter properties
| Type: | Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
None
Outputs
System.Object
Feedback
Was this page helpful?