Condividi tramite

  • Articolo

Set-CsAddressBookConfiguration

 

Ultima modifica dell'argomento: 2012-03-25

Modifica una raccolta esistente di impostazioni di configurazione della Rubrica.

Sintassi

Set-CsAddressBookConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-KeepDuration <UInt32>] [-MaxDeltaFileSizePercentage <UInt32>] [-RunTimeOfDay <DateTime>] [-SynchronizePollingInterval <TimeSpan>] [-UseNormalizationRules <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsAddressBookConfiguration [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-Instance <PSObject>] [-KeepDuration <UInt32>] [-MaxDeltaFileSizePercentage <UInt32>] [-RunTimeOfDay <DateTime>] [-SynchronizePollingInterval <TimeSpan>] [-UseNormalizationRules <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

I server della Rubrica sono intermediari tra Servizi di dominio Active Directory e Microsoft Lync Server 2010. Il server della Rubrica garantisce che le informazioni utente archiviate in Lync Server 2010 siano sincronizzate con le informazioni utente archiviate in Servizi di dominio Active Directory. A tale scopo, i file della Rubrica vengono sincronizzati regolarmente con le informazioni archiviate nel database degli utenti.

I server della Rubrica inoltre generano periodicamente file di indice che vengono scaricati nei computer che eseguono Lync 2010. Quando un utente ricerca i contatti, la ricerca viene effettuata in questi file di indice o nei file di indice della Rubrica archiviati nell'archivio di gestione centrale.

I server della Rubrica sono gestiti tramite le impostazioni di configurazione della Rubrica. Queste impostazioni determinano aspetti quali la frequenza con cui i file della Rubrica vengono sincronizzati con il database utente e la frequenza con cui vengono generati i file di indice della Rubrica. Quando si installa Lync Server, viene automaticamente creato un insieme di impostazioni globali della Rubrica. È inoltre possibile creare impostazioni di configurazione personalizzate che possono essere applicate a singoli siti. Queste impostazioni, se presenti, si applicano a qualsiasi server della Rubrica che operi nel sito e hanno sempre la precedenza sulle impostazioni globali.

Il cmdlet Set-CsAddressBookConfiguration consente di modificare qualsiasi raccolta di impostazioni di configurazione della Rubrica attualmente in uso nell'organizzazione.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco assegnato alla raccolta di impostazioni della Rubrica. Per fare riferimento alle impostazioni globali, utilizzare la sintassi seguente: -Identity global. Per far riferimento a una raccolta configurata nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Non è possibile utilizzare caratteri jolly quando si specifica un valore per il parametro Identity.

Se il parametro non viene impostato, Set-CsAddressBookConfiguration modificherà le impostazioni globali.

Instance

Obbligatorio

Oggetto AddressBookSettings

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

EnableFileGeneration

Facoltativo

Parametro opzionale

Se impostato su True (valore predefinito), il server della Rubrica genera file di indice della Rubrica che possono essere scaricati dai client. Se è impostato su False, i file di indice non vengono generati. Per le applicazioni client sarà pertanto necessario utilizzare il servizio query Web della Rubrica per la ricerca dei contatti.

IgnoreGenericRules

Facoltativo

Booleano

Indica se il server della Rubrica ignora le regole generiche di normalizzazione utilizzate durante l'analisi dei numeri di telefono. Le regole generiche sono regole predefinite di Lync Server 2010. Tali regole non sono modificabili. Se tuttavia si imposta il valore di questa proprietà su True, è possibile indicare ai server della Rubrica di ignorare queste regole e utilizzare invece le regole personalizzate create dall'utente. Il valore predefinito è False.

KeepDuration

Facoltativo

TimeSpan

Indica il periodo di tempo (in giorni) durante cui i file di modifica vengono conservati nel server della Rubrica. I file di modifica anteriori al valore della proprietà KeepDuration verranno eliminati. Il parametro KeepDuration può essere impostato su qualsiasi valore intero compreso tra 1 e 90, inclusi. Il valore predefinito è 30 giorni.

MaxDeltaFileSizePercentage

Facoltativo

Numero intero

Quando vengono eseguite modifiche in Active Directory (ad esempio viene abilitato un nuovo utente per Lync Server), il server della Rubrica registra in genere tali modifiche in un "file delta", ovvero un file contenente solo le informazioni aggiornate. Lync 2010 può quindi scaricare i file delta anziché un file della Rubrica completo. La proprietà MaxDeltaFileSizePercentage determina le dimensioni massime dei file delta prima che vengano incorporati nel file della Rubrica completo. Per impostazione predefinita, i file delta possono avere dimensioni pari al 20 percento del file della Rubrica completo, prima che venga generato un nuovo file di Rubrica. A questo punto, i client Lync scaricheranno il file completo, anziché un file delta.

MaxDeltaFileSizePercentage deve essere un valore percentuale compreso fra 1 e 100, inclusi.

RunTimeOfDay

Facoltativo

DateTime

Indica l'ora del giorno in cui i server generano nuovi file della Rubrica. La proprietà RunTimeOfDay si basa su un formato 24 ore (ore:minuti:secondi), in cui 00:00:00 rappresenta la mezzanotte e 23:59:00 rappresenta le 11:59 di sera.

Il valore predefinito è 01:30:00 (1:30 del mattino).

SynchronizePollingInterval

Facoltativo

TimeSpan

Indica la frequenza con cui i server della Rubrica sincronizzano le informazioni con quelle archiviate nel database degli utenti. Il parametro SynchronizePollingInterval può essere impostato su qualsiasi valore compreso tra 5 secondi (00:00:05) e 3 ore (03:00:00). Il valore predefinito è 5 minuti (00:05:00).

UseNormalizationRules

Facoltativo

Booleano

Indica se i server della Rubrica debbano utilizzare le regole di normalizzazione del telefono durante il recupero dei numeri telefonici. Se impostato su False, i numeri di telefono verranno recuperati così come sono e sarà responsabilità dell'applicazione client applicare le regole di normalizzazione durante la visualizzazione di tali numeri.

Il valore predefinito è True.

Force

Facoltativo

Parametro opzionale

Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'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

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings. Set-CsAddressBookConfiguration accetta l'input da pipeline degli oggetti di configurazione della Rubrica.

Tipi restituiti

Set-CsAddressBookConfiguration non restituisce un valore o un oggetto. Il cmdlet piuttosto configura le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

Esempio

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

Set-CsAddressBookConfiguration -identity site:Redmond -RunTimeOfDay 23:00

In questo esempio la proprietà RunTimeOfDay, che determina l'ora del giorno in cui viene eseguita la sincronizzazione della Rubrica, viene impostata su 23:00 (11:00 della sera) con un formato 24 ore. Il parametro Identity viene utilizzato per limitare la modifica alle impostazioni di configurazione della Rubrica con Identity site:Redmond.

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

Get-CsAddressBookConfiguration -Filter site:* | Set-CsAddressBookConfiguration -RunTimeOfDay 23:00

Nell'esempio 2 la proprietà RunTimeOfDay viene impostata sulle 11:00 della sera (23:00) per tutte le raccolte di impostazioni della Rubrica configurate nell'ambito del sito. A questo scopo, il comando chiama per prima cosa Get-CsAddressBookConfiguration insieme al parametro Filter, per restituire una raccolta di tutte le impostazioni specifiche del sito; il valore di filtro "site:*" limita i dati restituiti alle raccolte configurate nell'ambito del sito. Queste informazioni vengono quindi inviate tramite pipe a Set-CsAddressBookConfiguration, che modifica il valore della proprietà RunTimeOfDay di ciascun elemento della raccolta.

-------------------------- Esempio 3 --------------------------

Get-CsAddressBookConfiguration | Where-Object {$_.KeepDuration -lt 30} | Set-CsAddressBookConfiguration -KeepDuration 30

Il comando precedente modifica la proprietà KeepDuration di ogni raccolta di impostazioni della Rubrica in cui KeepDuration è inferiore a 30 giorni. Per eseguire questa operazione, viene utilizzato Get-CsAddressBookConfiguration senza ulteriori parametri, per restituire una raccolta di tutte le impostazioni della Rubrica configurate per l'utilizzo nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le impostazioni con proprietà KeepDuration impostata su un valore inferiore a 30 giorni. Questa raccolta filtrata viene quindi inviata tramite pipe a Set-CsAddressBookConfiguration, che modifica il valore della proprietà KeepDuration di ciascun elemento della raccolta in 30 giorni.