Condividi tramite

  • Articolo

New-CsUserReplicatorConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Crea una nuova raccolta di impostazioni di configurazione per User Replicator. Tale componente recupera periodicamente informazioni aggiornate sugli account utente da Active Directory e quindi sincronizza le nuove informazioni con i dati degli utenti correnti archiviati da Microsoft Lync Server 2010. Questo cmdlet è specifico per l'utilizzo con Microsoft Lync Online 2010 e non funzionerà con la versione locale di Lync Server 2010.

Sintassi

New-CsUserReplicatorConfiguration -Identity <XdsIdentity> [-ADDomainNamingContextList <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-ReplicationCycleInterval <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Sebbene Lync Server 2010 gestisca il proprio database di account utente e i dati di tali account, Lync Server si basa comunque su Active Directory come origine definitiva delle informazioni sugli utenti. Ad esempio, quando viene creato un nuovo account utente di Active Directory, è necessario fornire le informazioni di base sull'account utente, ad esempio il nome visualizzato di Active Directory. Quando un utente è abilitato per Lync Server, non è tuttavia necessario specificare un nuovo nome visualizzato, in quanto Lync Server 2010 utilizza il nome visualizzato già archiviato in Active Directory.

Le informazioni relative agli account utente, incluso il nome visualizzato di Active Directory, sono soggette a cambiamenti nel tempo. Ad esempio, un utente di sesso femminile che si sposa cambia cognome e quindi può avere necessità di cambiare anche il proprio nome visualizzato. Per assicurarsi che il database di Lync Server e Active Directory rimangano sincronizzati, Lync Server deve comunicare regolarmente con Active Directory, recuperare gli aggiornamenti più recenti relativi agli account utente e modificare di conseguenza il proprio database degli utenti. Tale sincronizzazione tra Active Directory e Lync Server viene effettuata dal componente User Replicator.

Durante l'installazione di Lync Server 2010, viene creato automaticamente un insieme globale di impostazioni di configurazione per User Replicator. Per impostazione predefinita, tali impostazioni vengono utilizzate per gestire User Replicator per l'intera organizzazione. La gestione di User Replicator consiste nell'identificare i domini con cui Lync Server deve eseguire la sincronizzazione, nonché nell'indicare la frequenza con cui User Replicator deve verificare la disponibilità di aggiornamenti degli account utente in Active Directory. È inoltre possibile creare ulteriori raccolte nell'ambito del servizio, ma solo se si utilizza Lync Online 2010.

Le nuove impostazioni di configurazione per User Replicator vengono create utilizzando il cmdlet New-CsUserReplicatorConfiguration. Tali impostazioni possono essere create solo nell'ambito del servizio ed esclusivamente per Lync Online 2010. Non è possibile creare nuove impostazioni di User Replicator per la versione locale di Lync Server.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsUserReplicatorConfiguration 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 "New-CsUserReplicatorConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco delle impostazioni di configurazione di User Replicator da creare. È possibile creare impostazioni solo con ambito servizio e unicamente per il servizio Registrar. Di conseguenza, le nuove impostazioni dovranno disporre di un parametro Identity analogo al seguente: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Ciò vale solo per Lync Online 2010.

ADDomainNamingContextList

Facoltativo

Modificatore elenco PS

Nomi distinti dei domini di Active Directory con cui User Replicator deve effettuare la sincronizzazione. Ad esempio, per aggiungere un dominio all'elenco, utilizzare una sintassi analoga alla seguente:

-ADDomainNamingContextList @{Add="dc=fabrikam,dc=com"}

È possibile aggiungere più di un nome di dominio quando viene chiamato New-CsUserReplicatorConfiguration. A tale scopo, è sufficiente separare i nomi dei domini con una virgola:

-ADDomainNamingContextList @{Add="dc=fabrikam,dc=com",”dc=contoso,dc=com”}

Se la proprietà viene impostata su un valore null, User Replicator individuerà ed effettuerà la sincronizzazione con tutti i domini disponibili. Se la proprietà non è impostata su null, User Replicator effettuerà la sincronizzazione solo con i domini specificati in ADDomainNamingContextList.

ReplicationCycleInterval

Facoltativo

TimeSpan

Indica per quanto tempo User Replicator deve attendere prima di verificare la disponibilità di eventuali aggiornamenti degli account utente in Active Directory. Come intervallo per il ciclo di replica è possibile specificare qualsiasi valore compreso tra 1 secondo e 23 ore, 59 minuti e 59 secondi. Il valore predefinito è 1 minuto. L'intervallo deve essere espresso utilizzando il formato hh:mm:ss (ore, minuti, secondi). Ad esempio, la seguente sintassi consente di impostare l'intervallo di tempo su 1 ora e 15 minuti: -ReplicationCycleInterval 01:15:00.

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.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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. New-CsUserReplicatorConfiguration non accetta l'input da pipeline.

Tipi restituiti

New-CsUserReplicatorConfiguration crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration.

Esempio

-------------------------- Esempio 1 ------------------------

New-CsUserReplicatorConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"

Il comando mostrato nell'esempio 1 crea una nuova raccolta di impostazioni di configurazione di User Replicator per il servizio Registrar:atl-cs-001.litwareinc.com. Poiché non sono specificati ulteriori parametri, la nuova raccolta utilizzerà i valori di User Replicator predefiniti.

-------------------------- Esempio 2 ------------------------

New-CsUserReplicatorConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com" -ADDomaiNamingContextList @{Add="dc=fabrikam,dc=com","dc=contoso.com"}

Nell'esempio 2 viene anche creata una nuova raccolta di impostazioni di configurazione del componente User Replicator per il servizio Registrar:atl-cs-001.litwareinc.com. In questo caso, viene però aggiunto AdDomainNamingContextList insieme ai nomi distinti dei due domini con cui effettuare la sincronizzazione, ovvero fabrikam.com e contoso.com. Tale nuova raccolta di impostazioni di configurazione di User Replicator verrà configurata solo con questi due domini, anche se ve ne sono altri disponibili.