Set-CsPstnUsage
Ultima modifica dell'argomento: 2012-03-25
Modifica un set di stringhe che identificano gli utilizzi della rete PSTN (Public Switched Telephone Network) consentiti. Questo cmdlet può essere utilizzato per aggiungere utilizzi all'elenco degli utilizzi PSTN o per rimuovere utilizzi da tale elenco.
Sintassi
Set-CsPstnUsage [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsPstnUsage [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Gli utilizzi di PSTN sono valori stringa utilizzati per l'autorizzazione delle chiamate. Un utilizzo di PSTN collega un criterio vocale a una route. Il cmdlet Set-CsPstnUsage consente di aggiungere utilizzi telefono all'elenco degli utilizzi o di rimuoverli dallo stesso. Questo elenco è globale, quindi può essere utilizzato dai criteri e dalle route nella distribuzione di Microsoft Lync Server 2010.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsPstnUsage i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsPstnUsage"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
L'ambito di applicazione di queste impostazioni. L'identità di questo cmdlet è sempre Global. |
Instance |
Facoltativo |
PstnUsages |
Un riferimento all'oggetto utilizzo PSTN. L'oggetto deve essere di tipo PstnUsages e può essere recuperato chiamando Get-CsPstnUsage. |
Usage |
Facoltativo |
PSListModifier |
Contiene un elenco di stringhe di utilizzo ammesse. Queste voci possono corrispondere a qualsiasi valore stringa. |
Force |
Facoltativo |
Parametro opzionale |
Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnUsages. Accetta l'input da pipeline di oggetti utilizzo PSTN.
Tipi restituiti
Questo cmdlet non restituisce un valore o un oggetto. Configura piuttosto le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnUsages.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsPstnUsage -Identity global -Usage @{add="International"}
Con questo comando viene aggiunta la stringa "International" all'elenco corrente di utilizzi PSTN disponibili.
-------------------------- Esempio 2 --------------------------
Set-CsPstnUsage -Identity global -Usage @{remove="Local"}
Questo comando consente la rimozione della stringa "Local" dall'elenco di utilizzi PSTN disponibili.
-------------------------- Esempio 3 --------------------------
Set-CsPstnUsage -Usage @{remove="Local"}
In questo esempio il comando consente di eseguire la stessa operazione vista nell'esempio 2: rimuove l'utilizzo PSTN "Local". In questo esempio viene mostrato il comando senza che venga specificato il parametro Identity. L'unico valore Identity disponibile per il cmdlet Set-CsPstnUsage è Global. Omettendo il parametro Identity, verrà pertanto utilizzato Global per impostazione predefinita.
-------------------------- Esempio 4 --------------------------
Set-CsPstnUsage -Usage @{replace="International","Restricted"}
Con questo comando vengono sostituiti tutti gli elementi nell'elenco di utilizzi con i valori International e Restricted. Tutti gli utilizzi esistenti in precedenza vengono rimossi.