Set-CsApplicationServer
Ultima modifica dell'argomento: 2012-03-27
Consente di modificare le proprietà di configurazione di uno o più server che eseguono Servizio applicazione. Questi server (noti anche come Application Server) ospitano programmi software quali applicazione Parcheggio di chiamata, che sono stati sviluppati utilizzando il gruppo Microsoft Unified Communications Managed API (UCMA).
Sintassi
Set-CsApplicationServer [-Identity <XdsGlobalRelativeIdentity>] [-ApplicationDatabase <String>] [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AtsSipPort <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-CaaSipPort <UInt16>] [-CasSipPort <UInt16>] [-Confirm [<SwitchParameter>]] [-CpsSipPort <UInt16>] [-Force <SwitchParameter>] [-PdpSipPort <UInt16>] [-PdpTurnPort <UInt16>] [-Registrar <String>] [-RgsSipPort <UInt16>] [-RgsWcfMtlsPort <UInt16>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Servizio applicazione ospita un numero di programmi di Microsoft Lync Server 2010 che non sono parte dei componenti server di base; tra questi programmi ci sono applicazione Response Group, applicazione Operatore Conferenza e applicazione Annuncio conferenza. Servizio applicazione riceve questi programmi e li integra totalmente nell'ambiente Lync Server 2010.
Il cmdlet Set-CsApplicationServer consente agli amministratori di modificare le impostazioni di configurazione di qualunque server applicazioni distribuito nell'organizzazione. Ad esempio, è possibile modificare le porte usate per audio, video e condivisione delle applicazioni oppure assegnare nuovi valori alle porte usate per singole applicazioni, come applicazione Operatore Conferenza o applicazione Annuncio conferenza. Si noti che ogni volta che si modificano le porte sarà poi necessario riavviare i relativi servizi.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsApplicationServer 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-CsApplicationServer"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsIdentity |
Percorso di installazione del server applicazioni da modificare. Ad esempio: -Identity "ApplicationServer:atl-cs-001.litwareinc.com". Si noti che è possibile non utilizzare il prefisso "ApplicationServer:" quando si specifica un server applicazioni. Ad esempio: -Identity "atl-cs-001.litwareinc.com". |
ApplicationDatabase |
Facoltativo |
Stringa |
Posizione del servizio di Database applicazione. Ad esempio: -ApplicationDatabase "ApplicationDatabase:atl-cs-001.litwareinc.com". |
AppSharingPortCount |
Facoltativo |
Numero intero |
Il numero totale di porte allocate per la condivisione delle applicazioni. Il numero di porte effettive da aprire inizia con il valore configurato per AudioPortStart e continua con il numero di porte specificato per AudioPortCount. Ad esempio, se AppSharingPortStart è impostato su 60000 e AppSharingPortCount è impostato su 100, per la condivisione delle applicazioni verranno utilizzate le porte da 60000 a 60099. |
AppSharingPortStart |
Facoltativo |
Numero intero |
La prima di una serie di porte allocate per la condivisione delle applicazioni. Ad esempio: –AppSharingPortStart 60000. |
AtsSipPort |
Facoltativo |
Numero intero |
Porta utilizzata dal servizio test audio. |
AudioPortCount |
Facoltativo |
Numero intero |
Il numero totale di porte allocate per l'invio e la ricezione di traffico audio. Il numero di porte effettive da aprire inizia con il valore configurato per AudioPortStart e continua con il numero di porte specificato per AudioPortCount. Ad esempio, se AudioPortStart è impostato su 60000 e AudioPortCount è impostato su 100, per il traffico audio verranno utilizzate le porte da 600000 a 60099. |
AudioPortStart |
Facoltativo |
Numero intero |
La prima di una serie di porte allocate per l'invio e la ricezione di traffico audio. Ad esempio: –AudioPortStart 60000. |
CaaSipPort |
Facoltativo |
Numero intero |
Porta SIP utilizzata da applicazione Operatore Conferenza, usata per collegare gli utenti ad una conferenza telefonica con accesso esterno. |
CasSipPort |
Facoltativo |
Numero intero |
Porta SIP utilizzata da applicazione Annuncio conferenza, usata per riprodurre gli annunci (ad esempio, "Davide Garghentini ha lasciato la conferenza") durante una conferenza. |
CpsSipPort |
Facoltativo |
Numero intero |
La porta SIP utilizzata per il servizio Parcheggio di chiamata. Il servizio Parcheggio di chiamata consente di mettere in attesa una chiamata su un telefono e riprendere la stessa chiamata da un altro telefono. |
PdpSipPort |
Facoltativo |
Numero intero |
Porta SIP utilizzata dal server PDP (Policy Decision Point, punto di decisione criteri). Il server PDP (Policy Decision Point, punto di decisione criteri) viene utilizzato per la gestione della larghezza di banda. |
PdpTurnPort |
Facoltativo |
Numero intero |
La porta traffico Turn utilizzata dal server PDP (Policy Decision Point, punto di decisione criteri). |
Registrar |
Facoltativo |
Stringa |
Nome di dominio completo della funzione di registrazione associata al server PDP (Policy Decision Point, punto di decisione criteri). |
RgsSipPort |
Facoltativo |
Numero intero |
Porta SIP utilizzata da applicazione Response Group. applicazione Response Group consente di indirizzare le chiamate telefoniche in arrivo a uno specifico gruppo di persone, come, ad esempio, il gruppo di supporto tecnico di una organizzazione. |
RgsWcfMtlsPort |
Facoltativo |
Numero intero |
Porta utilizzata per il traffico di (Windows Communication Foundation) WCF (mutual TLS) MTLS utilizzato da applicazione Response Group. |
VideoPortCount |
Facoltativo |
Numero intero |
Il numero totale di porte allocate per l'invio e la ricezione di traffico video. Il numero di porte effettive da aprire inizia con il valore configurato per VideoPortStart e continua con il numero di porte specificato per VideoPortCount. Ad esempio, se VideoPortStart è impostato su 60000 e VideoPortCount è impostato su 100, per il traffico video verranno utilizzate le porte da 60000 a 60099. |
VideoPortStart |
Facoltativo |
Numero intero |
La prima di una serie di porte allocate per l'invio e la ricezione di traffico video. Ad esempio, –VideoPortStart 60000. |
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 |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Nessuno. Set-CsApplicationServer non accetta input tramite pipeline.
Tipi restituiti
Set-CsApplicationServer non restituisce alcun oggetto o valore. Il cmdlet modifica invece le istanze esistenti dell'oggetto Microsoft.Rtc.Management.Xds.DisplayApplicationServer.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsApplicationServer -Identity "ApplicationServer:atl-cs-001.litwareinc.com" -CasSipPort 5074
Il comando riportato nell'Esempio 1 consente di configurare la porta SIP per applicazione Annuncio conferenza sul server applicazioni ApplicationServer:atl-cs-001.litwareinc.com to 5074.
-------------------------- Esempio 2 --------------------------
Set-CsApplicationServer -Identity "ApplicationServer:atl-cs-001.litwareinc.com" -AudioPortStart 49500 -AudioPortCount 5500
Il comando precedente consente di configurare le porte audio per il server applicazioni ApplicationServer:atl-cs-001.litwareinc.com. In questo esempio, la porta audio iniziale è impostata su 49500 e in totale sono 5500 le porte riservate al traffico audio.
-------------------------- Esempio 3 --------------------------
Get-CsService -ApplicationServer | ForEach-Object {Set-CsApplicationServer -Identity $_.Identity -CasSipPort 5074}
Nell'Esempio 3, la porta SIP di applicazione Annuncio conferenza viene impostata su 5074 per tutti i server applicazioni dell'organizzazione. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsService per ottenere una raccolta di tutti i server applicazioni attualmente in uso. Questa raccolta viene quindi inviata tramite pipe al cmdlet ForEach-Object che, per ogni singolo server nella raccolta, utilizza il cmdlet Set-CsApplicationServer per impostare la porta SIP di applicazione Annuncio conferenza su 5074.