Set-CsUserServer
Ultima modifica dell'argomento: 2012-04-23
Consente di modificare un pool di servizi utente esistente. Tra le altre cose, tale pool fornisce informazioni sulla presenza e facilita la gestione delle conferenze.
Sintassi
Set-CsUserServer [-Identity <XdsGlobalRelativeIdentity>] [-ConferenceServer <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-McuFactorySipPort <UInt16>] [-UserDatabase <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
I servizi utente sono un componente completo per l'esecuzione di diversi ruoli chiave di Microsoft Lync Server 2010. Ad esempio, forniscono informazioni sulla presenza, consentono di gestire le conferenze mediante Focus e Focus Factory, gestiscono l'autorizzazione degli utenti e il routing a livello utente e fungono da interfaccia principale per il database di back-end. I servizi utente consentono inoltre di eseguire il provisioning degli account utente.
Per questo motivo, è importante per gli amministratori sapere esattamente come sono stati configurati i pool di servizi utente e, se necessario, modificare tali configurazioni. È possibile recuperare le informazioni sui pool di servizi utente utilizzando questo comando:
Get-CsService -UserServer
Analogamente, è possibile utilizzare il cmdlet Set-CsUserServer per apportare modifiche a questi pool. Set-CsUserServer consente agli amministratori di cambiare il database degli utenti e/o il server per conferenze associato a un pool. Questo cmdlet consente inoltre di modificare la porta utilizzata per le connessioni a Focus Factory.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsUserServer 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-CsUserServer"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
L'identificatore univoco per il pool di servizi utente da modificare. Ad esempio: -Identity "UserServer:atl-cs-001.litwareinc.com". È possibile omettere il prefisso "UserServer:" quando si specifica un server utente. Ad esempio: -Identity "atl-cs-001.litwareinc.com". |
ConferenceServer |
Facoltativo |
Stringa |
L'ID servizio del server per conferenze associato al pool di servizi utente. Ad esempio: -ConferenceServer "ConferenceServer:atl-cs-001.litwareinc.com". |
McuFactorySipPort |
Facoltativo |
Numero intero |
Porta utilizzata per la connessione a Focus Factory (McuFactory). Focus Factory alloca unità MCU (Media Control Unit) per aggiungere tipi di elementi multimediali specifici, come l'audio, alle conferenze. |
UserDatabase |
Facoltativo |
Stringa |
L'ID di servizio per il database degli utenti associato al pool di servizi utente. Ad esempio: -UserDatabase "UserDatabase: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 |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Nessuno. Set-CsUserServer non accetta l'input da pipeline.
Tipi restituiti
Set-CsUserServer non restituisce alcun oggetto o valore. In realtà il cmdlet modifica le istanze esistenti dell'oggetto Microsoft.Rtc.Management.Xds.DisplayUserServer.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsUserServer -Identity "UserServer:atl-cs-001.litwareinc.com" -McuFactorySipPort 445
Il comando indicato nell'esempio 1 consente di modificare la porta McuFactorySipPort per un singolo pool di servizi utente: ovvero, il pool con il parametro Identity UserServer:atl-cs-001.litwareinc.com. In questo esempio la porta viene impostata su 445.
-------------------------- Esempio 2 ------------------------
Get-CsService -UserServer | ForEach-Object {Set-CsUserServer -Identity $_.Identity -McuFactorySipPort 445}
Il comando mostrato nell'esempio 2 è una variante del comando dell'esempio 1. In questo caso, la porta McuFactorySipPort viene però modificata per tutti i pool di servizi utente nell'organizzazione. A tale scopo, nel comando vengono innanzitutto utilizzati Get-CsService e il parametro UserServer per restituire una raccolta di tutti i pool di servizi utente attualmente in uso. La raccolta viene quindi inviata tramite pipe al cmdlet ForEach-Object, che individua ciascun pool della raccolta e imposta McuFactorySipPort su 445. I dati devono essere inviati tramite pipe a ForEach-Object, in quanto il cmdlet Set-CsUserServer non può accettare direttamente i dati da pipeline.