New-CsStaticRoute
Ultima modifica dell'argomento: 2012-03-26
Consente di creare una nuova route telefonica statica.
Sintassi
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TLSRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>] [-TLSCertIssuer <String>] [-TLSCertSerialNumber <Byte[]>] [-UseDefaultCertificate <$true | $false>]
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TCPRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>]
Descrizione dettagliata
Quando si invia un messaggio SIP a qualcuno, quel messaggio potrebbe dover attraversare più subnet e reti prima di essere consegnato; il percorso effettuato dal messaggio viene spesso chiamato "route". Nelle reti, esistono due tipi di route: dinamiche e statiche. Con le route dinamiche, i server utilizzano degli algoritmi per stabilire la destinazione successiva (prossimo hop) dove inoltrare il messaggio. Con le route statiche, il percorso del messaggio viene stabilito a priori dagli amministratori di sistema. Quando un messaggio viene ricevuto da un server, questo controlla l'indirizzo del messaggio e lo inoltra al prossimo server che è stato preconfigurato da un amministratore. Se configurate correttamente le route statiche aiutano ad assicurare una tempestiva ed accurata consegna del messaggio senza sovraccarico sul server. Lo svantaggio delle route statiche è rappresentato dal fatto che i messaggi non vengono dinamicamente reinstradati nel caso di un errore di rete.
Le nuove route statiche vengono create utilizzando il cmdlet New-CsStaticRoute. Una volta che la route è stata creata tramite il cmdlet New-CsStaticRoute, è necessario aggiungerla a una raccolta di impostazioni di configurazione delle route utilizzando li cmdlet Set-CsStaticRoutingConfiguration.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsStaticRoute 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 "New-CsStaticRoute"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Destination |
Obbligatorio |
Stringa |
Se la route utilizza il protocollo TLS (Transport Layer Security) come protocollo di trasporto, il valore del parametro Destination è il nome di dominio completo del server hop successivo. Ad esempio: -Destination "atl-proxy-001.litwareinc.com". Se la route utilizza il protocollo TCP (Transmission Control Protocol) come protocollo di trasporto, il valore del parametro Destination è l'indirizzo IP del router hop successivo. Ad esempio: -Destination "192.168.0.240". |
MatchUri |
Obbligatorio |
Stringa |
Il nome di dominio completo (FQDN) o il suffisso di dominio utilizzato per stabilire se il messaggio è diretto a un utente gestito da questa route. Ad esempio, è possibile utilizzare il nome FQDN "litwareinc.com". Questo modello include tutti gli utenti con indirizzo SIP che termina con il nome di dominio "litwareinc.com". Per includere tutti i domini figli di un dominio, è possibile utilizzare un valore con carattere jolly come "*.litwareinc.com". Questo valore include tutti i domini che terminano con il suffisso "litwareinc.com". Ad esempio: northamerica.litwareinc.com; asia.litwareinc.com; europe.litwareinc.com. |
Enabled |
Facoltativo |
Booleano |
Se impostato su True, la route è abilitata e per tutti i messaggi conformi al modello MatchURI verrà effettuato il routing al server hop successivo. Se impostato su False, la route è disabilitata e non verrà utilizzata per il routing dei messaggi. Il valore predefinito è True. |
MatchOnlyPhoneUri |
Facoltativo |
Booleano |
Se impostato su True, solo i messaggi indirizzati agli URI telefonici (ad esempio, sip:kenmmyer@litwareinc.com;user=phone) verranno inclusi ed eventualmente inoltrati. Se impostato su False (il valore predefinito), vengono inclusi tutti i messaggi. |
Port |
Obbligatorio |
Numero intero |
Numero di porta usato per il routing SIP. Ad esempio: -Port 7742. |
ReplaceHostInRequestUri |
Facoltativo |
Booleano |
Se impostato su True ($True), la porzione host di un URI richiesta verrà sostituita dall'indirizzo del server hop successivo. Se impostato su False, l'URI richiesta verrà utilizzato senza alterazioni. L'URI richiesta rappresenta l'URI dell'utente o servizio a cui è indirizzata la richiesta (messaggio). Il valore predefinito è False. |
TCPRoute |
Facoltativo |
Parametro opzionale |
Consente di configurare il protocollo TCP come protocollo di trasporto della nuova route. |
TLSCertIssuer |
Facoltativo |
Stringa |
Nome dell'Autorità di certificazione che ha emesso il certificato da utilizzare nella route statica. Questo parametro non viene utilizzato, se non è stato configurato il protocollo TCP come protocollo di trasporto. Se viene incluso il parametro TLSCertIssuer, occorre anche utilizzare il parametro TLSCertSerialNumber. |
TLSCertSerialNumber |
Facoltativo |
Matrice di byte |
Il numero di serie del certificato TLS da utilizzare nella route statica. I numeri di serie devono essere specificati sotto forma di matrice di byte; ciò significa che occorre specificare il numero di serie sotto forma di una matrice di valori di due caratteri. Ad esempio: -TLSCertSerialNumber 0x01, 0xA4, 0xD5, 0x67, 0x89. Questo parametro non viene utilizzato, se non è stato configurato il protocollo TCP come protocollo di trasporto. Se viene incluso il parametro TLSCertSerialNumber, occorre anche utilizzare il parametro TLSCertIssuer. |
TLSRoute |
Facoltativo |
Parametro opzionale |
Consente di configurare il protocollo TLS come protocollo di trasporto della nuova route. |
UseDefaultCertificate |
Facoltativo |
Booleano |
Consente di configurare la route in modo che utilizzi il certificato Lync Server 2010 predefinito come certificato di autenticazione. Se non si desidera utilizzare il certificato predefinito, è necessario specificarne un altro utilizzando i parametri TLSCertIssuer e TLSCertSerialNumber. Per visualizzare i certificati predefiniti, utilizzare il seguente comando: Get-CsCertificate | Where-Object {$_.Use –eq "urn:certref:Default"} |
Tipi di input
Nessuno. New-CsStaticRoute non accetta input tramite pipeline.
Tipi restituiti
New-CsStaticRoute crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Route.
Esempio
-------------------------- Esempio 1 --------------------------
$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "litwareinc.com"
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
I comandi riportati nell'Esempio 1 consentono di creare una nuova route statica e di aggiungerla alla raccolta di configurazioni del routing statico nell'ambito globale. Per eseguire questa operazione, il primo comando utilizza il cmdlet New-CsStaticRoute per creare solo in memoria una route che utilizza il protocollo TCP come protocollo di trasporto. La route punta all'indirizzo 192.168.0.100 dell'hop successivo, utilizza la porta 8025 e include tutti gli URI provenienti dal dominio litwareinc.com. L'oggetto route risultante viene memorizzato in una variabile denominata $x.
Il secondo comando nell'esempio aggiunge poi la nuova route alla raccolta di configurazioni del routing statico nell'ambito globale. Per ottenere questo risultato, viene utilizzato il cmdlet Set-CsStaticRoutingConfiguration insieme al parametro Route. Il valore del parametro @{Add=$x} consente di aggiungere l'oggetto route memorizzato nella variabile $x all''insieme di route già presenti nella raccolta globale.
-------------------------- Esempio 2 --------------------------
$x = New-CsStaticRoute -TLSRoute -Destination "atl-proxy-001.litwareinc.com" -Port 8025 -MatchUri "*.litwareinc.com" -UseDefaultCertificate $True
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
L'Esempio 2 mostra come creare una nuova route statica che utilizza il protocollo TLS come protocollo di trasporto e di aggiungerla poi alla raccolta di configurazioni del routing statico nell'ambito globale. Per eseguire questa operazione, il primo comando riportato nell'esempio utilizza il cmdlet New-CsStaticRoute per creare solo in memoria una route che utilizza il protocollo TLS come protocollo di trasporto. La route punta all'indirizzo "atl-proxy-001.litwareinc.com" come destinazione, utilizza la porta 8025 e include tutti gli URI provenienti dal dominio con suffisso "litwareinc.com". Inoltre, il nuovo oggetto route, memorizzato in una variabile denominata $x, utilizza il certificato predefinito per le procedure di autenticazione (-UseDefaultCertificate $True).
Una volta creato l'oggetto route, il secondo comando nell'esempio consente di aggiungere la nuova route alla raccolta di configurazioni del routing statico nell'ambito globale.