Condividi tramite

  • Articolo

New-CsAddressBookConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Consente di creare una nuova raccolta di impostazioni di configurazione della Rubrica.

Sintassi

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

Descrizione dettagliata

I server della Rubrica sono intermediari tra AD DS e Microsoft Lync Server 2010. Il server della Rubrica garantisce che le informazioni dell'utente archiviate in Lync Server 2010 siano sincronizzate con quelle archiviate in AD DS. Questo risultato viene ottenuto sincronizzando periodicamente i file della Rubrica con le informazioni archiviate nel database degli utenti.

Inoltre, i server della Rubrica creano periodicamente file della Rubrica che vengono scaricati sui computer che eseguono Lync 2010. Quando un utente ricerca un contatto, la ricerca viene effettuata in questi file di indice o nei file di indice della Rubrica archiviati in archivio di gestione centrale.

I server della Rubrica sono gestiti tramite le impostazioni di configurazione Rubrica; queste impostazioni determinano quanto spesso i server della Rubrica debbano essere sincronizzati con i database utente e la frequenza di generazione dei file di indice della rubrica. Quando si installa Lync Server, viene creato un gruppo di impostazioni della Rubrica globali. È possibile anche creare impostazioni di configurazione personalizzate che possono essere applicate a singoli siti. Tali configurazioni, se presenti, si applicano a qualsiasi server della Rubrica nel sito ed hanno sempre la precedenza sulle impostazioni globali.

Le impostazioni a livello di sito vengono create utilizzando il cmdlet New-CsAddressBookConfiguration. È possibile creare le impostazioni solo nell'ambito del sito. La creazione di nuove impostazioni in altri ambiti, compreso l'ambito globale, avrà esito negativo. Il comando avrà esito negativo anche se il sito contiene già una raccolta di impostazioni della Rubrica.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsAddressBookConfiguration 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 "New-CsAddressBookConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco da assegnare alla nuova raccolta di impostazioni della Rubrica. Poiché è possibile creare nuove raccolte solo nell'ambito del sito, l'identità avrà sempre il prefisso "site:" seguito dal nome del sito; ad esempio "site:Redmond".

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, questi file di indice non vengono generati. Ciò significa che le applicazioni client dovranno utilizzare servizio query Web della Rubrica per cercare un contatto.

IgnoreGenericRules

Facoltativo

Booleano

Indica se il server della Rubrica ignorerà le regole generiche di normalizzazione utilizzate durante l'analisi dei numeri telefonici. Le regole generiche sono le regole incorporate in Lync Server 2010. Non è possibile modificare queste regole. Tuttavia, impostando il valore di questa proprietà su True, è possibile fare in modo che i server della Rubrica non utilizzino tali regole, ma utilizzino invece le regole personalizzate create dall'utente. Il valore predefinito è False.

KeepDuration

Facoltativo

Numero intero

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 apportate modifiche ad Active Directory (ad esempio, se viene abilitato un nuovo utente per Lync Server), le modifiche vengono in genere registrate dal server della Rubrica in un "file delta", ovvero un file costituito solo dalle informazioni aggiornate. Tramite Lync 2010 è quindi possibile scaricare i file delta anziché un file della Rubrica completo. La proprietà MaxDeltaFileSizePercentage determina le dimensioni massime dei file delta prima di essere incorporati nel file completo della Rubrica. Per impostazione predefinita, i file delta possono avere dimensioni pari al 20% del file della Rubrica completo prima che venga generato un nuovo file della Rubrica. Tramite i client Lync viene quindi scaricato il file completo anziché il file delta.

MaxDeltaFileSizePercentage deve essere immesso come valore percentuale, da 1 a 100, compresi.

RunTimeOfDay

Facoltativo

Data/ora

Indica l'ora e il giorno in cui i server creano nuovi file della Rubrica. La proprietà RunTimeOfDay si basa sul formato 24 ore (ore:minuti:secondi), con 00:00:00 che indica la mezzanotte e 23:59:00 che indica le undici e cinquantanove di sera.

Il valore predefinito è 01:30:00 (l'una e trenta di mattina).

SynchronizePollingInterval

Facoltativo

Durata

Indica la frequenza con cui i server della Rubrica sincronizzano le informazioni con quelle archiviate in database degli utenti. Il parametro SynchronizePollingInterval può essere impostato su qualunque 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 devono utilizzare le regole di normalizzazione dei numeri telefonici quando recuperano i numeri di telefono. Se impostato su False, i numeri di telefono verranno recuperati così come sono e sarà l'applicazione client ad applicare le regole di normalizzazione quando li visualizza.

Il valore predefinito è True.

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-CsAddressBookConfiguration non accetta input tramite pipeline.

Tipi restituiti

Consente di creare le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

Esempio

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

New-CsAddressBookConfiguration -Identity site:Redmond -KeepDuration 15 -SynchronizePollingInterval 00:10:00

Nell'esempio precedente viene creata una nuova raccolta di impostazioni di configurazione della Rubrica con Identity site:Redmond. Per creare una nuova raccolta è necessario eseguire il cmdlet New-CsAddressBookConfiguration insieme al parametro Identity e qualunque altro parametro facoltativo (ad esempio, i parametri KeepDuration e SynchronizePollingInterval).

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

$x = Get-CsAddressBookConfiguration -Identity site:Redmond
New-CsAddressBookConfiguration -Identity site:Paris -KeepDuration $x.KeepDuration -SynchronizePollingInterval $x.SynchronizePollingInterval

Nell'Esempio 2 viene creata una nuova raccolta di impostazioni della Rubrica per site:Paris; questa nuova raccolta utilizza due valori (KeepDuration e SynchronizePollingInterval) copiati dalla raccolta site:Redmond. Per eseguire questa operazione, il primo comando utilizza Get-CsAddressBookConfiguration per ottenere una raccolta di tutte le impostazioni della Rubrica configurate per il sito Redmond; questa informazione viene memorizzata nella variabile denominata $x.

Il secondo comando poi utilizza New-CsAddressBookConfiguration per creare le impostazioni della Rubrica per il sito Paris. Il secondo comando include due parametri facoltativi (KeepDuration e SynchronizePollingInterval) che contengono i valori copiati da site:Redmond. Ad esempio, KeepDuration usa il valore di parametro $x.KeepDuration; quel valore di parametro rappresenta le informazioni KeepDuration copiate dal sito Redmond.

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

$x = New-CsAddressBookConfiguration -Identity site:Redmond -InMemory
$x.KeepDuration = 15
$x.SynchronizePollingInterval = "00:10:00"
Set-CsAddressBookConfiguration -Instance $x

Nell'Esempio 3 viene illustrato come poter utilizzare il parametro InMemory per creare un'istanza solo in memoria di una raccolta di impostazioni della Rubrica, modificare tali impostazioni in memoria ed utilizzare Set-CsAddressBookConfiguration per creare una raccolta effettiva con Identity site:Redmond. Per eseguire le operazioni, il primo comando crea una nuova istanza solo in memoria di una configurazione delle impostazioni della Rubrica, archiviando tale istanza in una variabile denominata $x. Il parametro InMemory garantisce che tali impostazioni della Rubrica siano presenti solo in memoria. Nel caso in cui si termini a sessione Windows PowerShell o si elimini a variabile $x, le impostazioni verranno rimosse e non verranno applicate al sito Redmond.

Nei comandi 2 e 3 vengono modificate due proprietà della raccolta di impostazioni "virtuali" della Rubrica: il comando 2 imposta il valore della proprietà KeepDuration su 15 giorni e il comando 3 imposta SynchronizePollingInterval su 10 minuti (00:10:00). Il quarto e ultimo comando utilizza Set-CsAddressBookConfiguration e il parametro Instance per trasformare le impostazioni della Rubrica virtuali in una raccolta effettiva di impostazioni configurate nel sito Redmond.