Set-CsPstnGateway
Ultima modifica dell'argomento: 2012-03-26
Consente di modificare le proprietà di un gateway PSTN (Public Switched Telephone Network). I gateway PSTN consentono di eseguire il routing delle chiamate tra i dispositivi sulla rete PSTN esterna e i dispositivi sulla rete interna di VoIP aziendale.
Sintassi
Set-CsPstnGateway [-Identity <XdsGlobalRelativeIdentity>] [-AlternateByPassId <String>] [-Confirm [<SwitchParameter>]] [-Default <$true | $false>] [-Force <SwitchParameter>] [-GatewaySipClientTcpPort <Nullable>] [-GatewaySipClientTlsPort <Nullable>] [-MediationServer <String>] [-RepresentativeMediaIP <String>] [-Routable <$true | $false>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
I gateway PSTN consentono agli utenti di VoIP aziendale di effettuare e ricevere chiamate telefoniche da utenti che non si trovano sulla rete PSTN. Questi gateway fungono da collegamento tra Mediation Server e la rete PSTN.
Generalmente, è necessario utilizzare i gateway PSTN nei sistemi telefonici PBX (Private Branch Exchange) di tipo TDM (Time Division Multiplex); in questo caso, di norma è necessario utilizzare un PSTN e un Mediation Server per instradare le chiamate di VoIP aziendale alla rete PSTN. Al contrario, se si utilizza un sistema IP-PBX, è possibile creare una connessione SIP diretta tra il sistema PBX e Mediation Server, eliminando così la necessità di un gateway PSTN.
Dopo aver installato e configurato i gateway PSTN, è possibile gestirli utilizzando il cmdlet Set-CsPstnGateway.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsPstnGateway può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsPstnGateway"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsIdentity |
Identità del servizio del gateway PSTN da modificare. Ad esempio: -Identity "PstnGateway:192.168.0.240". Si noti che è possibile non utilizzare il prefisso "PstnGatewayServer:" quando si specifica un gateway PSTN. Ad esempio: -Identity "atl-cs-001.litwareinc.com". |
AlternateBypassId |
Facoltativo |
Guid |
Identificatore univoco globale (GUID) che rappresenta il BypassID alternativo. Questo ID viene generato automaticamente da Lync Server 2010 e consente di eliminare le chiamate "hairpin". A seconda della configurazione del sistema, questo parametro consente alle chiamate "hairpin" di ignorare automaticamente Mediation Server senza che sia necessario definire e associare singole subnet a tutti i siti e a tutte le aree. Per ottenere questo risultato, è necessario abilitare a livello globale la funzionalità di bypass in modo da utilizzare aree e siti di configurazione di rete e quindi abilitare la funzionalità di bypass sulla configurazione trunk del gateway PSTN. Si parla di chiamata "hairpin" quando una chiamata in arrivo dalla rete PSTN viene reinstradata alla rete PSTN mediante la funzione di inoltro chiamata o di squillo simultaneo. |
Default |
Facoltativo |
Booleano |
Se impostato su True, questo gateway gestisce le chiamate da Office Communications Server 2007 R2. Nella raccolta di gateway gestiti da un unico Mediation Server, può essere presente un solo gateway predefinito. |
GatewaySipClientTcpPort |
Facoltativo |
Numero intero |
Porta di attesa utilizzata per comunicare con i server Mediation Server tramite protocollo TCP (Transmission Control Protocol). Il valore predefinito è 5066. |
GatewaySipClientTlsPort |
Facoltativo |
Numero intero |
Porta di attesa utilizzata per comunicare con i server Mediation Server tramite protocollo TLS (Transport Layer Security). Il valore predefinito è 5067. |
MediationServer |
Facoltativo |
Stringa |
Identità del servizio di Mediation Server da associare al gateway PSTN. Ad esempio: -MediationServer "MediationServer:atl-cs-001.litwareinc.com". |
RepresentativeMediaIP |
Facoltativo |
Stringa |
Indirizzo IP del processore multimediale associato al gateway, se l'ubicazione del processore è diversa dall'indirizzo di segnalazione. Entrambe le funzionalità di bypass multimediale e controllo di ammissione di chiamata (CAC) si basano sull'ubicazione del processore multimediale del gateway; per impostazione predefinita, questa ubicazione corrisponde all'indirizzo di segnalazione. Se le due ubicazioni sono diverse (ad esempio, il processore multimediale si trova presso un sito remoto e quello di segnalazione presso il sito centrale), è necessario configurare la proprietà RepresentativeMediaIP con l'indirizzo IP del processore multimediale. Se presso un unico sito sono stati distribuiti più processori multimediali ciascuno con un proprio indirizzo IP, è possibile utilizzare uno qualsiasi di questi indirizzi IP per configurare la proprietà RepresentativeMediaIP. |
Routable |
Facoltativo |
Booleano |
Se impostato su True, il gateway può essere utilizzato per il routing in uscita. |
Force |
Facoltativo |
Stringa |
Consente di evitare la visualizzazione di prompt di conferma o messaggi di errore non irreversibile che possono verificarsi quando si esegue il cmdlet. |
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
Nessuno. Get-CsPstnGateway non accetta input tramite pipeline.
Tipi restituiti
Set-CsPstnGateway non restituisce alcun oggetto o valore. In realtà, il cmdlet consente di modificare le istanze esistenti dell'oggetto Microsoft.Rtc.Management.Xds.DisplayPstnGateway.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsPstnGateway -Identity "PstnGateway:192.168.0.240" -Default $True
Il comando illustrato nell'Esempio 1 consente di configurare il gateway PstnGateway:192.168.0.240 in modo che sia il gateway predefinito. Ciò significa che PstnGateway:192.168.0.240 può essere utilizzato per gestire le chiamate originate da Office Communications Server 2007 R2.
-------------------------- Esempio 2 ------------------------
Get-CsService -PstnGateway | ForEach-Object {Set-CsPstnGateway -Identity $_.Identity -Routable $True}
Il comando precedente consente di configurare tutti i gateway PSTN dell'organizzazione, garantendo che ogni gateway possa essere utilizzato nel routing in uscita. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsService e il parametro PstnGateway per ottenere una raccolta di tutti i gateway PSTN al momento utilizzati. Questa raccolta viene quindi inviata tramite pipe al cmdlet ForEach-Object. ForEach-Object utilizza il cmdlet Set-CsPstnGateway su ciascun gateway nella raccolta e per ognuno imposta la proprietà Routable su True.