[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Modifies a set of strings that identify the allowed public switched telephone network (PSTN) usages. This cmdlet can be used to add usages to the list of PSTN usages, remove usages from the list, or modify usages in the list.

Syntax


Set-CsPstnUsage [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]


Set-CsPstnUsage [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter	Required	Type	Description
Identity	Optional	XdsIdentity	The level at which these settings are applied. The Identity for this cmdlet is always Global.
Confirm	Optional	SwitchParameter	Prompts you for confirmation before executing the command.
Force	Optional	SwitchParameter	Suppresses any confirmation prompts that would otherwise be displayed before making changes.
Instance	Optional	PstnUsages	A reference to a PSTN usage object. This object must be of type PstnUsages and can be retrieved by calling Get-CsPstnUsage.
Usage	Optional	PSListModifier	Contains a list of allowable usage strings. These entries can be any string value.
WhatIf	Optional	SwitchParameter	Describes what would happen if you executed the command without actually executing the command.

Detailed Description

PSTN usages are string values that are used for call authorization. A PSTN usage links a voice policy to a route. The Set-CsPstnUsage cmdlet is used to add or remove phone usages to or from the usage list. This list is global so it can be used by policies and routes throughout the Microsoft Communications Server 2010 deployment.

Return Types

This cmdlet does not return a value or object. Instead, it configures instances of the Microsoft.Rtc.Management.WriteableConfig.Policy.Voice.PstnUsages object.

Examples

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

	Copy Code
Set-CsPstnUsage -Identity global -Usage @{add="International"}

This command adds the string "International" to the current list of available PSTN usages.

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

	Copy Code
Set-CsPstnUsage -Identity global -Usage @{remove="Local"}

This command removes the string "Local" from the list of available PSTN usages.

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

	Copy Code
Set-CsPstnUsage -Usage @{remove="Local"}

The command in this example performs the exact same action as in Example 2: it removes the "Local" PSTN usage. This example shows the command without the Identity parameter specified. The only Identity available to the Set-CsPstnUsage cmdlet is the Global identity; therefore omitting the Identity parameter defaults to Global.

-------------------------- Example 4 --------------------------

	Copy Code
Set-CsPstnUsage -Usage @{replace="International","Restricted"}

This command replaces everything in the usage list with the values International and Restricted. All previously existing usages are removed.