Set-CsTeamsIPPhonePolicy
Set-CsTeamsIPPhonePolicy enables you to modify the properties of an existing Teams phone policy settings.
Syntax
Set-CsTeamsIPPhonePolicy
[[-Identity] <XdsIdentity>]
[-AllowBetterTogether <String>]
[-AllowHomeScreen <String>]
[-AllowHotDesking <Boolean>]
[-Confirm]
[-Description <String>]
[-Force]
[-HotDeskingIdleTimeoutInMinutes <Int>]
[-Instance <Object>]
[-SearchOnCommonAreaPhoneMode <String>]
[-SignInMode <String>]
[-Tenant <Guid>]
[-WhatIf]
[<CommonParameters>] Description
Set-CsTeamsIPPhonePolicy enables you to modify the properties of an existing TeamsIPPhonePolicy.
Examples
Example 1
PS C:\> Set-CsTeamsIPPhonePolicy -Identity CommonAreaPhone -SignInMode CommonAreaPhoneSigninThis example shows the SignInMode "CommonAreaPhoneSignIn" being set against the policy named "CommonAreaPhone".
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
| Type: | String |
| Position: | Named |
| Default value: | Enabled |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowHomeScreen
Determines whether the Home Screen feature of the Teams IP Phones is enabled. Possible values this parameter can take:
- Enabled
- EnabledUserOverride
- Disabled
| Type: | String |
| Position: | Named |
| Default value: | EnabledUserOverride |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowHotDesking
Determines if the hot desking feature is enabled or not. Set this to TRUE to enable. Set this to FALSE to disable hot desking mode.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Free form text that can be used by administrators as desired.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HotDeskingIdleTimeoutInMinutes
Determines the idle timeout value in minutes for the signed in user account. When the timeout is reached, the account is logged out.
| Type: | Int |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Identity
The identity of the policy. To specify the global policy for the organization, use "global". To specify any other policy provide the name of that policy.
| Type: | XdsIdentity |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SearchOnCommonAreaPhoneMode
Determines whether a user can look up contacts from the tenant's global address book when the phone is signed into the Common Area Phone Mode. Set this to ENABLED to enable the feature. Set this to DISABLED to disable the feature.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-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'
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tenant
Internal Microsoft use only.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
System.Management.Automation.PSObject
Outputs
System.Object