Set-CsPstnUsage
Última modificación del tema: 2012-03-25
Modifica un conjunto de cadenas de caracteres que identifican los usos permitidos de la red telefónica conmutada (RTC). Este cmdlet se puede utilizar para agregar usos a la lista de usos de RTC o quitar usos de la lista.
Sintaxis
Set-CsPstnUsage [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsPstnUsage [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Los usos de RTC son valores de cadenas de caracteres que se usan para la autorización de llamadas. Un uso de RTC vincula una directiva de voz con una ruta. El cmdlet Set-CsPstnUsage se usa para agregar o quitar usos de teléfono de la lista de usos. Esta lista es global, pueden usarla tanto las directivas como las rutas de toda la implementación de Microsoft Lync Server 2010.
Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Set-CsPstnUsage localmente los miembros de los siguientes grupos: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsPstnUsage"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
El ámbito en el que se aplican estas configuraciones. La identidad de este cmdlet siempre es Global. |
Instance |
Opcional |
PstnUsages |
Referencia a un objeto de uso de RTC. Este objeto debe ser de tipo PstnUsages y puede recuperarse llamando al cmdlet Get-CsPstnUsage. |
Usage |
Opcional |
Modificador de lista PS |
Contiene una lista de cadenas de caracteres de uso permitidas. Estas entradas pueden ser cualquier valor de cadena de caracteres. |
Force |
Opcional |
Parámetro modificador |
Suprime los mensajes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnUsages. Acepta la entrada por canalización de objetos de uso de RTC.
Tipos de valores devueltos
Este cmdlet no devuelve un objeto o valor. Por el contrario, configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnUsages.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsPstnUsage -Identity global -Usage @{add="International"}
Este comando agrega la cadena de caracteres "International" a la lista actual de usos de RTC disponibles.
-------------------------- Ejemplo 2 --------------------------
Set-CsPstnUsage -Identity global -Usage @{remove="Local"}
Este comando quita la cadena de caracteres "Local" de la lista de usos de RTC disponibles.
-------------------------- Ejemplo 3 --------------------------
Set-CsPstnUsage -Usage @{remove="Local"}
El comando de este ejemplo ejecuta la misma acción que el Ejemplo 2: quita el uso de RTC "Local". Este ejemplo muestra el comando sin el parámetro Identity especificado. El único valor de Identity disponible para el cmdlet Set-CsPstnUsage es la identidad Global; si no se especifica el parámetro Identity, se usará la opción predeterminada Global.
-------------------------- Ejemplo 4 --------------------------
Set-CsPstnUsage -Usage @{replace="International","Restricted"}
Este comando reemplaza todos los valores de la lista de usos por los valores International y Restricted. Todos los usos anteriores se quitan.