Set-CsConferenceServer
Ultima modifica dell'argomento: 2012-03-26
Modifica le proprietà di un A/V Conferencing Server (detto anche server per conferenze). Il server per conferenze fornisce le funzionalità audio e video per le conferenze.
Sintassi
Set-CsConferenceServer [-Identity <XdsGlobalRelativeIdentity>] [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AppSharingSipPort <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-AudioVideoSipPort <UInt16>] [-Confirm [<SwitchParameter>]] [-DataPsomPort <UInt16>] [-EdgeServer <String>] [-Force <SwitchParameter>] [-ImSipPort <UInt16>] [-MeetingPsomPort <UInt16>] [-PhoneSipPort <UInt16>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
I server per conferenze (detti anche A/V Conferencing Server) sono utilizzati per fornire capacità audio e video alle conferenze. A sua volta, il cmdlet Set-CsConferenceServer consente di modificare le proprietà di questi server; in particolare, è possibile specificare quali porte utilizzare per il traffico audio, il traffico video e la condivisione di applicazioni. È inoltre possibile utilizzare Set-CsConferenceServer per associare un dato server a un particolare Edge Server o Server di archiviazione.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsConferenceServer in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsConferenceServer"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
Posizione del servizio del componente Conference Server da modificare. Ad esempio: -Identity "ConferencingServer:atl-cs-001.litwareinc.com". È possibile tralasciare il prefisso "ConferencingServer:" quando si specifica un server per conferenze. Ad esempio: -Identity "atl-cs-001.litwareinc.com". |
AppSharingSipPort |
Facoltativo |
Numero intero |
Porta SIP utilizzata per ascoltare le richieste per la condivisione di applicazioni. Le porte effettivamente utilizzate per la condivisione di applicazioni sono configurate utilizzando AppSharingPortStart e AppSharingPortCount. |
AppSharingPortCount |
Facoltativo |
Numero intero |
Numero totale di porte allocate per la condivisione delle applicazioni. Le porte effettive da aprire iniziano dalla porta con il valore configurato per AppSharingPortStart e proseguono per il numero di porte specificato in AppSharingPortCount. Ad esempio, se AppSharingPortStart è impostato su 60000 e AppSharingPortCount è impostato su 100, per la condivisione delle applicazioni saranno utilizzate le porte da 60000 a 60099. |
AppSharingPortStart |
Facoltativo |
Numero intero |
Prima porta nell'intervallo di porte allocate per la condivisione delle applicazioni. Ad esempio: -AppSharingPortStart 60000. |
AudioPortCount |
Facoltativo |
Numero intero |
Numero totale di porte allocate per l'invio e la ricezione del traffico audio. Le porte effettive da aprire iniziano dalla porta con il valore configurato per AudioPortStart e proseguono per il numero di porte specificato in AudioPortCount. Ad esempio, se AudioPortStart è impostato su 60000 e AudioPortCount è impostato su 100, per il traffico audio saranno utilizzate le porte da 60000 a 60099. |
AudioPortStart |
Facoltativo |
Numero intero |
Prima porta nell'intervallo di porte allocate per l'invio e la ricezione del traffico audio. Ad esempio: –AudioPortStart 60000. |
AudioVideoSipPort |
Facoltativo |
Numero intero |
Porta SIP utilizzata per ascoltare le richieste in arrivo per il servizio audio e video. Le porte effettivamente utilizzate per il traffico audio e video sono configurate utilizzando AudioPortCount, AudioPortStart, VideoPortCount e VideoPortStart. |
DataPsomPort |
Facoltativo |
Numero intero |
Porta dati utilizzata dal protocollo PSOM (Persistent Shared Object Model). |
EdgeServer |
Facoltativo |
Stringa |
Percorso di servizio del Edge Server da associare al server per conferenze. Ad esempio: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com". |
ImSipPort |
Facoltativo |
Numero intero |
Porta utilizzata per il traffico di messaggistica istantanea. |
MeetingPsomPort |
Facoltativo |
Numero intero |
Porta utilizzata per il protocollo PSOM (Persistent Shared Object Model), un protocollo di Microsoft utilizzato per le conferenze. |
PhoneSipPort |
Facoltativo |
Numero intero |
Porta utilizzata per il traffico di telefonia. |
VideoPortCount |
Facoltativo |
Numero intero |
Numero totale di porte allocate per l'invio e la ricezione del traffico video. Le porte effettive da aprire iniziano dalla porta con il valore configurato per VideoPortStart e proseguono per il numero di porte specificato in VideoPortCount. Ad esempio, se VideoPortStart è impostato su 60000 e VideoPortCount è impostato su 100, per il traffico video saranno utilizzate le porte da 60000 a 60099. |
VideoPortStart |
Facoltativo |
Numero intero |
Prima porta nell'intervallo di porte allocato per l'invio e la ricezione del 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-CsConferenceServer non accetta l'input da pipeline.
Tipi restituiti
Set-CsConferenceServer non restituisce alcun oggetto o valore. Il cmdlet modifica invece le istanze esistenti dell'oggetto Microsoft.Rtc.Management.Xds.DisplayConferenceServer.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsConferenceServer -Identity "ConferencingServer:atl-cs-001.litwareinc.com" -ImSipPort 5075
Il comando illustrato nell'esempio 1 consente di modificare la porta SIP di messaggistica istantanea per il componente Conference Server ConferencingServer:atl-cs-001.litwareinc.com. In questo esempio la porta viene impostata su 5075.
-------------------------- Esempio 2 ------------------------
Get-CsService -ConferencingServer | ForEach-Object {Set-CsConferenceServer -Identity $_.Identity -ImSipPort 5075}
L'esempio 2 è una variazione del comando illustrato nell'esempio 1. In questo caso, però, la porta SIP di messaggistica istantanea viene modificata per tutti i componenti Conference Server nell'organizzazione. A tale scopo, nel comando vengono innanzitutto utilizzati Get-CsService e il parametro ConferencingServer per restituire una raccolta di tutti i server per conferenze attualmente in uso. La raccolta viene quindi inviata tramite pipe al cmdlet ForEach-Object, che esegue Set-CsConferenceServer su ogni server nella raccolta, impostando ImSipPort su 5075.