Set-CsEdgeServer
Ultima modifica dell'argomento: 2012-03-26
Modifica i valori delle proprietà per uno o più server perimetrali. Tali server vengono utilizzati per fornire connettività tra la rete interna e Internet.
Sintassi
Set-CsEdgeServer [-Identity <XdsGlobalRelativeIdentity>] [-AccessEdgeClientSipPort <UInt16>] [-AccessEdgeExternalSipPort <Nullable>] [-AccessEdgeInternalSipPort <UInt16>] [-Confirm [<SwitchParameter>]] [-DataPsomClientPort <Nullable>] [-DataPsomServerPort <UInt16>] [-Force <SwitchParameter>] [-MediaCommunicationPortCount <UInt16>] [-MediaCommunicationPortStart <UInt16>] [-MediaRelayAuthEdgePort <UInt16>] [-MediaRelayExternalTurnTcpPort <UInt16>] [-MediaRelayExternalTurnUdpPort <UInt16>] [-MediaRelayInternalTurnTcpPort <UInt16>] [-MediaRelayInternalTurnUdpPort <UInt16>] [-Registrar <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
La connettività con il mondo esterno, ovvero Internet, è un aspetto importante di Microsoft Lync Server 2010. Senza questa connettività, gli utenti dovrebbero connettersi alla rete interna per poter accedere a Lync Server 2010. In questo modo per gli utenti che lavorano fuori sede sarebbe difficile utilizzare il software e impedirebbe agli utenti che non dispongono di account nel dominio di partecipare alle conferenze. Analogamente, senza la connettività con il mondo esterno gli utenti non sarebbero in grado di scambiare messaggi istantanei con i partner federati o con le persone che dispongono di account in un sistema pubblico di messaggistica istantanea, ad esempio Yahoo!, AOL o MSN.
I server perimetrali garantiscono la connettività tra la rete interna e Internet. Il cmdlet Set-CsEdgeServer consente di modificare le impostazioni di configurazione dei server perimetrali, un'attività che consiste principalmente nel modificare i numeri di porta utilizzati per trasmettere il traffico di rete.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsEdgeServer 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-CsEdgeServer"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
Posizione del servizio del Edge Server da modificare. Ad esempio: -Identity "EdgeServer:atl-edge-001.litwareinc.com". È possibile omettere il prefisso "EdgeServer:" quando si specifica un server perimetrale, ad esempio -Identity "atl-cs-001.litwareinc.com". |
AccessEdgeClientSipPort |
Facoltativo |
Numero intero |
Porta utilizzata per le comunicazioni SIP tra Edge Server e i dispositivi client. Il valore iniziale viene impostato in Generatore di topologie, ma può essere modificato specificando un nuovo valore per il parametro. |
AccessEdgeExternalSipPort |
Facoltativo |
Numero intero |
Porta utilizzata per il traffico SIP esterno. Il valore predefinito è 5061. |
AccessEdgeInternalSipPort |
Facoltativo |
Numero intero |
Porta utilizzata per il traffico SIP interno. Il valore predefinito è 5061. |
DataPsomClientPort |
Facoltativo |
Numero intero |
Porta utilizzata per le comunicazioni PSOM (Persistent Shared Object Model) tra Edge Server e i dispositivi client. Il valore iniziale viene impostato in Generatore di topologie, ma può essere modificato specificando un nuovo valore per il parametro. |
DataPsomServerPort |
Facoltativo |
Numero intero |
Porta utilizzata per le comunicazioni PSOM tra il Edge Server e altri server. |
MediaCommunicationPortCount |
Facoltativo |
Numero intero |
Numero totale di porte allocate per le comunicazioni multimediali nel perimetro esterno. Il valore predefinito è 10000. |
MediaCommunicationPortStart |
Facoltativo |
Numero intero |
Numero di porta iniziale per le comunicazioni multimediali nel perimetro esterno. Il valore predefinito è 50000. |
MediaRelayAuthEdgePort |
Facoltativo |
Numero intero |
Porta utilizzata per l'autenticazione Media Relay. Il valore predefinito è 5062. |
MediaRelayExternalTurnTcpPort |
Facoltativo |
Numero intero |
Porta utilizzata per il traffico esterno di Media Relay tramite TCP (Transmission Control Protocol). Il valore predefinito è 444 se al server perimetrale è associato un solo indirizzo IP. Se al server perimetrale sono associati più indirizzi IP, il valore predefinito è 443. Questi valori vengono impostati inizialmente in Generatore di topologie, ma possono essere modificati specificando un nuovo valore per il parametro. |
MediaRelayExternalTurnUdpPort |
Facoltativo |
Numero intero |
Porta utilizzata per il traffico esterno di Media Relay tramite UDP (User Datagram Protocol). Il valore predefinito è 3478. |
MediaRelayInternalTurnTcpPort |
Facoltativo |
Numero intero |
Porta utilizzata per il traffico interno di Media Relay tramite TCP. Il valore predefinito è 443. |
MediaRelayInternalTurnUdpPort |
Facoltativo |
Numero intero |
Porta utilizzata per il traffico interno di Media Relay tramite UDP. Il valore predefinito è 3478. |
Registrar |
Facoltativo |
Stringa |
Posizione del servizio di registrazione da associare al Edge Server. Ad esempio: -Registrar "Registrar:atl-cs-001.litwareinc.com". |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Nessuno. Set-CsEdgeServer non accetta l'input da pipeline.
Tipi restituiti
Set-CsEdgeServer non restituisce alcun oggetto o valore. Modifica le istanze esistenti dell'oggetto Microsoft.Rtc.Management.Xds.DisplayEdgeServer.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsEdgeServer -Identity "EdgeServer:atl-edge-001.litwareinc.com" -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062
Con il comando mostrato nell'esempio 1 vengono cambiate le porte SIP interne ed esterne del Edge Server "EdgeServer:atl-edge-001.litwareinc.com".
-------------------------- Esempio 2 ------------------------
Get-CsService -EdgeServer | Where-Object {$_.SiteId -eq "site:Redmond"} | ForEach-Object {Set-CsEdgeServer Identity $_.Identity -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062}
Nell'esempio 2 vengono modificate le porte SIP interne ed esterne per tutti i server perimetrali situati nel sito di Redmond. A tale scopo, vengono utilizzati innanzitutto Get-CsService e il parametro EdgeServer per restituire una raccolta di tutti i server perimetrali attualmente in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo i server perimetrali del sito Redmond, ovvero i siti con proprietà SiteId uguale a site:Redmond. La raccolta filtrata viene quindi inviata tramite pipe al cmdlet For-Each-Object. Questo cmdlet esegue Set-CsEdgeServer in ogni server della raccolta, cambiando i valori assegnati alle proprietà AccessInternalSipPort e AccessExternalSipPort.