Set-CsAutodiscoverConfiguration
Ultima modifica dell'argomento: 2012-04-23
Modifica una raccolta esistente di impostazioni di configurazione del servizio di individuazione automatica, che 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
Set-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsAutodiscoverConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WebLinks <PSListModifier>] [-WhatIf [<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. Queste impostazioni a loro volta possono essere applicate all'ambito globale o all'ambito del sito. Quando si installa Lync Server, viene creata automaticamente una raccolta globale di impostazioni. A tale raccolta tuttavia non viene assegnato alcun URL di individuazione automatica. Se una singola raccolta di impostazioni di individuazione automatica non soddisfa le proprie esigenze, è possibile utilizzare il cmdlet New-CsAutoDiscoverConfiguration per creare ulteriori impostazioni di configurazione nell'ambito del sito. Da tale posizione è possibile utilizzare il cmdlet Set-CsAutoDiscoverConfiguration per aggiungere o rimuovere gli URL di individuazione automatica dalla raccolta globale o da qualsiasi raccolta nell'ambito del sito.
Utenti autorizzati a eseguire questo cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-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 modificare. Per modificare la raccolta globale, utilizzare la sintassi seguente: -Identity "global" Per modificare una raccolta configurata nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond" Se questo parametro non è specificato, il cmdlet Set-CsAutoDiscoverConfiguration modificherà automaticamente le impostazioni globali. |
Instance |
Facoltativo |
Oggetto AutoDiscoverConfiguration |
Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. |
WebLinks |
Facoltativo |
Modificatore elenco PS |
Raccolta di URL di individuazione automatica. Questi URL devono essere creati tramite il cmdlet New-CsWebLink. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di qualunque messaggio di errore non irreversibile che potrebbe essere generato nel corso dell'esecuzione del comando. |
Tipi di input
Set-CsAutoDiscoverConfiguration accetta l'input da pipeline dell'oggetto Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.
Tipi restituiti
Nessuno. Set-CsAutoDiscoverConfiguration modifica istanze dell'oggetto Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.
Esempio
-------------------------- Esempio 1 --------------------------
$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1}
I comandi illustrati nell'esempio 1 consentono di aggiungere un nuovo URL di individuazione automatica (http://LyncDiscover.fabrikam.com) alle impostazioni di configurazione del servizio di individuazione automatica assegnate al sito Redmond. A tale scopo, nel primo comando dell'esempio viene utilizzato il cmdlet New-CsWebLink per creare un nuovo URL di individuazione automatica. Tale URL viene archiviato in una variabile denominata $Link1. Nel secondo comando viene utilizzato Set-CsAutoDiscoverConfiguration per aggiungere il nuovo URL agli URL già assegnati a queste impostazioni. Questa operazione viene effettuata utilizzando il parametro WebLinks e il valore di parametro @{Add=$Link1}.
-------------------------- Esempio 2 --------------------------
$Link1 = Get-CsAutoDiscoverConfiguration -Identity "site:Redmond" | Select-Object -ExpandProperty WebLinks | Where-Object {$_.Token -eq "Fabrikam"}
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Remove=$Link1}
Con i comandi precedenti viene illustrato come rimuovere un URL da una raccolta di impostazioni di configurazione del servizio di individuazione automatica. A tale scopo, il primo comando della raccolta recupera un riferimento oggetto all'URL da eliminare (un URL con Token uguale a "Fabrikam"). Questa operazione viene effettuata innanzitutto chiamando il cmdlet Get-CsAutoDiscoverConfiguration per recuperare le impostazioni di individuazione automatica per il sito Redmond. Tale raccolta viene quindi inviata tramite pipe al cmdlet Select-Object, che utilizza il parametro ExpandProperty per "espandere" la proprietà WebLinks. Quando una proprietà è espansa, viene fornito a Get-CsAutoDiscoverConfiguration l'accesso ai singoli oggetti in essa archiviati. Questi oggetti WebLinks vengono quindi inviati tramite pipe al cmdlet Where-Object, che seleziona l'oggetto con proprietà Token uguale a "Fabrikam". Tale oggetto WebLinks viene quindi archiviato in una variabile denominata $Link1.
Nel secondo comando dell'esempio viene quindi utilizzato Set-CsAutoDiscoverConfiguration per rimuovere l'oggetto archiviato in $Link1. A tale scopo, nel comando vengono utilizzati il parametro WebLinks e il valore di parametro @{Remove=$Link1}.
-------------------------- Esempio 3 --------------------------
$Link2 = New-CsWebLink -Token "Contoso" -Href "http://LyncDiscover.contoso.com"
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Replace=$Link2}
Nell'esempio 3 viene illustrato come sostituire una raccolta esistente di URL di individuazione automatica con, in questo caso, un singolo URL. Per eseguire questa operazione, nel primo comando dell'esempio viene utilizzato il cmdlet New-CsWebLink per creare un nuovo URL di individuazione automatica per http://LyncDiscover.contoso.com. L'URL risultante viene archiviato in una variabile denominata $Link2. Nel secondo comando vengono quindi utilizzati il cmdlet Set-CsAutoDiscoverConfiguration e il parametro WebLinks per rimuovere gli URL precedentemente assegnati al sito Redmond e sostituirli con l'URL per http://LyncDiscover.contoso.com. A tale scopo, nel comando viene utilizzato il metodo Replace anziché il metodo Add o Remove.
-------------------------- Esempio 4 --------------------------
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks $Null
Il comando illustrato nell'esempio 4 consente di rimuovere tutti gli URL di individuazione automatica assegnati al sito Redmond. A tale scopo, il comando imposta la proprietà WebLinks su un valore Null. In questo modo vengono eliminati tutti gli URL precedentemente assegnati a tale proprietà.