Condividi tramite

  • Articolo

Get-CsAddressBookConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sulle impostazioni di configurazione della Rubrica.

Sintassi

Get-CsAddressBookConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsAddressBookConfiguration [-Filter <String>] [-LocalStore <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 Active Directory. Per eseguire questa operazione i file della Rubrica vengono periodicamente sincronizzati con le informazioni archiviate nel database degli utenti.

Inoltre, i server della Rubrica generano periodicamente file di indice che vengono scaricati sui computer che eseguono Lync 2010. Quando un utente ricerca dei contatti, la ricerca viene effettuata tramite questi file di indice o tramite i 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 con quale frequenza i file della Rubrica vengono sincronizzati con il database dell'utente e con quale frequenza vengono generati questi file di indice della Rubrica. Durante l'installazione di Lync Server 2010 viene automaticamente creato un set di impostazioni globali della Rubrica. È inoltre possibile creare impostazioni di configurazione personalizzate che possono essere applicate ai singoli siti. Queste impostazioni, se esistono, si applicano a qualsiasi server della Rubrica che operi nel sito e hanno la precedenza sulle impostazioni globali.

È possibile utilizzare il cmdlet Get-CsAddressBookConfiguration per restituire informazioni su una o su tutte le impostazioni della Rubrica attualmente in uso nell'organizzazione.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-CsAddressBookConfiguration in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAddressBookConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco per la raccolta di impostazioni della Rubrica da restituire. 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.

Si noti che non è possibile utilizzare i caratteri jolly quando si specifica un parametro Identity. Tuttavia, se è necessario utilizzare caratteri jolly, includere il parametro Filter.

Se questo parametro non viene specificato, Get-CsAddressBookConfiguration restituisce una raccolta di tutte le impostazioni della Rubrica in uso nell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per restituire una raccolta (o più raccolte) di impostazioni della Rubrica. Ad esempio, per restituire una raccolta di tutte le impostazioni configurate nell'ambito del sito, utilizzare la sintassi riportata di seguito: -Filter site:*. Per restituire una raccolta di tutte le impostazioni in cui la stringa "EMEA" compare nell'identità, utilizzare la seguente sintassi: -Filter *EMEA*.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati di configurazione della Rubrica dalla replica locale del archivio di gestione centrale anziché dal archivio di gestione centrale stesso.

Tipi di input

Nessuno. Get-CsAddressBookConfiguration non accetta l'input da pipeline.

Tipi restituiti

Get-CsAddressBookConfiguration restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

Esempio

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

Get-CsAddressBookConfiguration

Con l'esempio precedente vengono restituite informazioni su tutte le impostazioni di configurazione della Rubrica in uso nell'organizzazione. È il comportamento predefinito se si chiama Get-CsAddressBookConfiguration senza alcun parametro aggiuntivo.

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

Get-CsAddressBookConfiguration -Identity site:Redmond

Con l'esempio 2 vengono restituite informazioni sulle impostazioni di configurazione della Rubrica con identità site:Redmond.

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

Get-CsAddressBookConfiguration -Filter site:*

Con l'esempio precedente vengono utilizzati il parametro Filter e il valore del filtro "site:*" per restituire informazioni su tutte le impostazioni di configurazione della Rubrica applicate nell'ambito del sito. Il valore del filtro fornito consente di restituire informazioni per tutte le impostazioni della Rubrica la cui identità inizia con il valore stringa "site:".

-------------------------- Esempio 4 --------------------------

Get-CsAddressBookConfiguration | Where-Object {$_.UseNormalizationRules -eq $True}

Con l'esempio 4 vengono restituite informazioni per tutte le impostazioni di configurazione della Rubrica in cui le impostazioni utilizzano le regole di normalizzazione durante l'analisi dei numeri di telefono. Per ottenere tale risultato, il comando utilizza per prima cosa Get-CsAddressBookConfiguration per restituire una raccolta di tutte le impostazioni della Rubrica nell'organizzazione. La raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona solo le impostazioni in cui UseNormalizationRules equivale a True.