Get-CsAutodiscoverConfiguration
Ultima modifica dell'argomento: 2012-04-23
Restituisce informazioni sulle impostazioni di configurazione del servizio di individuazione automatica attualmente in uso in un'organizzazione. Tale servizio consente ad applicazioni client come Lync Web Access o Microsoft Lync Mobile di individuare risorse chiave come ad esempio il pool principale di un utente o l'URL per partecipare a una conferenza telefonica con accesso esterno.
Sintassi
Get-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAutodiscoverConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrizione dettagliata
Per un utilizzo ottimale di Microsoft Lync Server 2010 nelle applicazioni client, è necessario che tali applicazioni conoscano il percorso dei componenti chiave di Lync Server 2010. Gli utenti autenticati, ad esempio, devono essere in grado di individuare il proprio pool principale. Dopotutto possono essere autenticati solo da tale pool. Analogamente, gli utenti non autenticati devono essere in grado di eseguire operazioni come l'individuazione dell'URL utilizzato per partecipare a una conferenza.
Se tutti gli utenti hanno eseguito l'accesso all'interno del firewall dell'organizzazione, l'individuazione di tali percorsi è relativamente semplice. Questa operazione tuttavia si complica quando gli utenti accedono al sistema dall'esterno utilizzando Microsoft Lync Mobile o Lync Web Access.
Questa situazione si verifica in modo particolare in scenari di dominio diviso, in cui alcuni utenti di un'organizzazione dispongono di account nella versione locale di Lync Server, mentre altri dispongono di account in Microsoft Office 365. In questi casi, gli account utente possono trovarsi in foreste di Active Directory diverse e questo può rivelarsi problematico. Se, ad esempio, un utente degli Stati Uniti accede dall'Europa, il sistema deve essere in grado di riconoscere la relativa foresta e quindi associare la richiesta di accesso al pool appropriato.
Il servizio di individuazione automatica è stato introdotto nella versione di Lync Server di novembre 2011 per ovviare a questi problemi. Quando un'applicazione client tenta di accedere a Lync Server, il servizio di individuazione automatica analizza l'indirizzo SIP del client e quindi reindirizza la richiesta al pool appropriato. Le applicazioni client si connettono al servizio di individuazione automatica inviando una richiesta HTTP a un URL di individuazione automatica. Per il corretto funzionamento del servizio di individuazione automatica, è necessario che questi URL siano configurati dagli amministratori. Oltre a configurare gli URL, gli amministratori devono anche creare record DNS corrispondenti a tali URL.
Gli URL di individuazione automatica vengono assegnati alle impostazioni di configurazione del servizio di individuazione automatica, le quali a loro volta possono essere applicate all'ambito globale o all'ambito del sito. Il cmdlet Get-CsAutoDiscoverConfiguration restituisce informazioni sulle impostazioni del servizio di individuazione automatica, e sugli URL di individuazione automatica, attualmente in uso nell'organizzazione.
Utenti autorizzati a eseguire questo cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsAutoDiscoverConfiguration i membri dei gruppi seguenti: RTCUniversalServerAdmins.
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
Identificatore univoco per la raccolta di impostazioni di configurazione del servizio di individuazione automatica da recuperare. Per recuperare le impostazioni globali, utilizzare la sintassi seguente: -Identity "global" Per recuperare le impostazioni configurate nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond" Se questo parametro non viene incluso, Get-CsAutoDiscoverConfiguration restituisce tutte le impostazioni di configurazione del servizio di individuazione automatica attualmente in uso nell'organizzazione. |
Filter |
Facoltativo |
Stringa |
Consente di utilizzare i caratteri jolly per specificare l'identità delle impostazioni di configurazione del servizio di individuazione automatica da restituire. Con la sintassi seguente, ad esempio, vengono restituite tutte le impostazioni configurate nell'ambito del sito: -Filter "site:*" Si noti che non è possibile utilizzare entrambi i parametri Identity e Filter nello stesso comando. |
LocalStore |
Facoltativo |
Parametro opzionale |
Recupera i dati di configurazione del servizio di individuazione automatica dalla replica locale dell'archivio di gestione centrale anziché direttamente dall'archivio di gestione centrale. |
Tipi di input
Get-CsAutoDiscoverConfiguration non accetta input da pipeline.
Tipi restituiti
Get-CsAutoDiscoverConfiguration restituisce istanze dell'oggetto Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsAutoDiscoverConfiguration
Tramite il comando illustrato nell'esempio 1 vengono restituite tutte le impostazioni di configurazione del servizio di individuazione automatica attualmente in uso nell'organizzazione.
-------------------------- Esempio 2 --------------------------
Get-CsAutoDiscoverConfiguration -Identity "global"
Nell'esempio 2 viene restituita solo una raccolta di impostazioni di configurazione del servizio di individuazione automatica, ovvero la raccolta globale.
-------------------------- Esempio 3 --------------------------
Get-CsAutoDiscoverConfiguration -Filter "site:*"
Tramite il comando precedente vengono restituite tutte le impostazioni di configurazione del servizio di individuazione automatica assegnate all'ambito del sito. A tale scopo, viene incluso il parametro Filter insieme al valore di filtro "site:*". Questo valore di filtro garantisce che vengano restituite solo le impostazioni con parametro Identity che inizia con il valore di stringa "site:". Per definizione, le impostazioni con un parametro Identity che inizia con "site:" sono impostazioni configurate nell'ambito del sito.
-------------------------- Esempio 4 --------------------------
Get-CsAutoDiscoverConfiguration | Where-Object {$_.WebLinks -like "*fabrikam.com"}
Tramite il comando illustrato nell'esempio 4 vengono restituite tutte le impostazioni di configurazione del servizio di individuazione automatica che includono un URL di individuazione automatica per fabrikam.com. Per effettuare questa operazione, nel comando viene utilizzato innanzitutto Get-CsAutoDiscoverConfiguration per restituire una raccolta di tutte le impostazioni del servizio di individuazione automatica attualmente in uso nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le impostazioni in cui la proprietà WebLinks include il valore di stringa "fabrikam.com".