Set-CsMcxConfiguration
Ultima modifica dell'argomento: 2012-04-23
Modifica una raccolta specificata di impostazioni di configurazione del servizio per dispositivi mobili Microsoft Lync Server 2010. Il servizio per dispositivi mobili consente agli utenti di cellulari, come iPhone e Windows Phone, di eseguire operazioni quali lo scambio di messaggi istantanei e di informazioni sulla presenza, l'archiviazione e il recupero dei messaggi in segreteria telefonica internamente anziché tramite il provider wireless e l'utilizzo di funzionalità di Microsoft Lync Server 2010 come la caratteristica Chiamata tramite ufficio e le conferenze telefoniche con chiamata esterna.
Sintassi
Set-CsMcxConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-ExposedWebURL <External | Internal>] [-Force <SwitchParameter>] [-PushNotificationProxyUri <String>] [-SessionExpirationInterval <UInt32>] [-SessionShortExpirationInterval <UInt32>] [-WhatIf [<SwitchParameter>]]
Set-CsMcxConfiguration [-Confirm [<SwitchParameter>]] [-ExposedWebURL <External | Internal>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-PushNotificationProxyUri <String>] [-SessionExpirationInterval <UInt32>] [-SessionShortExpirationInterval <UInt32>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il servizio per dispositivi mobili Microsoft Lync Server 2010 estende numerose funzionalità di Microsoft Lync 2010 a dispositivi mobili come Apple iPhone, Windows Phone, telefoni Android e telefoni Nokia. Gli utenti possono tra l'altro utilizzare questi telefoni per scambiare messaggi istantanei e informazioni sulla presenza e per ricevere notifiche di nuovi messaggi in segreteria telefonica. Grazie al servizio notifica Push (servizio notifica Push Apple e servizio notifica Push Microsoft Lync Server 2010), gli utenti con telefoni iPhone o Windows Phone possono ricevere queste notifiche anche se Lync 2010 è in esecuzione in background. Il servizio per dispositivi mobili consente inoltre alle organizzazioni di abilitare la caratteristica Chiamata tramite ufficio. Con questa caratteristica, gli utenti possono effettuare una chiamata dal proprio cellulare e fare in modo che risulti provenire dal telefono dell'ufficio. Ad esempio, tramite i sistemi ID chiamante verrà visualizzato il numero dell'ufficio dell'utente anziché il numero del relativo cellulare.
Il servizio per dispositivi mobili viene gestito utilizzando le impostazioni di configurazione del servizio per dispositivi mobili che possono essere applicate all'ambito globale, del sito o del servizio (solo per il servizio del server Web). Queste impostazioni controllano aspetti come la durata massima di una sessione del servizio per dispositivi mobili, la disponibilità del servizio di individuazione automatica di Microsoft Lync Server 2010 (che indirizza gli utenti del servizio per dispositivi mobili al pool di registrazione appropriato) per gli utenti che eseguono l'accesso al di fuori del firewall dell'organizzazione e la posizione del provider del servizio notifica Push.
Il cmdlet Set-CsMcxConfiguration consente agli amministratori di modificare qualsiasi impostazione di configurazione del servizio per dispositivi mobili esistente.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsMcxConfiguration i membri dei gruppi seguenti: RTCUniversalServerAdmins.
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
Rappresenta l'identificatore univoco della raccolta di impostazioni di configurazione del servizio per dispositivi mobili da modificare. Per modificare le impostazioni globali, utilizzare la sintassi seguente: -Identity global Per modificare le impostazioni nell'ambito del sito, utilizzare il prefisso "site:" seguito dal nome del sito. Ad esempio: -Identity "site:Redmond" Per modificare le impostazioni configurate nell'ambito del servizio, utilizzare una sintassi simile alla seguente: -Identity service:WebServer:atl-cs-001.litwareinc.com Se questo parametro non viene specificato, Set-CsMcxConfiguration modifica le impostazioni globali. |
ExposedWebURL |
Facoltativo |
Oggetto ExposedWebURL |
Indica se gli utenti possono accedere all'URL utilizzato dal servizio di individuazione automatica sia dall'interno che dall'esterno del firewall dell'organizzazione (External) oppure solo dall'interno del firewall (Internal). I valori consentiti sono: Internal o External. Il valore predefinito è External. |
Instance |
Facoltativo |
Oggetto MCXConfiguration |
Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. |
PushNotificationProxyUri |
Facoltativo |
Stringa |
URI di un provider di servizi che può inoltrare le richieste di notifiche Push al servizio notifica Push Apple e al servizio notifica Push Microsoft Lync Server 2010. PushNotificationProxyUri deve avere il formato di un indirizzo SIP, ad esempio: -PushNotificationProxyUri "sip:push@push.lync.com" |
SessionExpirationInterval |
Facoltativo |
Numero intero |
Durata, in secondi, di una sessione mobile per utenti di iPhone o Windows Phone. Se Lync 2010 è in esecuzione in background su questi telefoni, gli utenti riceveranno le notifiche Push finché l'intervallo di durata della sessione non scade. Il dispositivo mobile deve inviare un avviso al server per indicare che il dispositivo è ancora attivo prima del raggiungimento del timeout della sessione. In caso contrario, il dispositivo viene contrassegnato come non attivo e l'utente deve eseguire di nuovo l'accesso al sistema. Questa proprietà può essere impostata su qualsiasi valore intero compreso tra 120 e 4294967295, inclusi. Il valore predefinito è 259200 secondi (3 giorni). Si noti che il valore della proprietà SessionExpirationInterval deve essere maggiore di quello della proprietà SessionShortExpirationInterval. |
SessionShortExpirationInterval |
Facoltativo |
Numero intero |
Durata, in secondi, di una sessione mobile per utenti di telefoni Android o Nokia. Il dispositivo portatile deve inviare un avviso per il server che indica che il dispositivo è ancora attivo prima del raggiungimento del timeout della sessione. Se non esiste, il dispositivo verrà elencato come inattivo e l'utente dovrà accedere al sistema. Questa proprietà può essere impostata su qualsiasi valore intero compreso tra 120 e 4294967295, inclusi. Il valore predefinito è 259200 secondi (3 giorni). Si noti che il valore della proprietà SessionExpirationInterval deve essere maggiore di quello della proprietà SessionShortExpirationInterval. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di qualunque messaggio di errore non irreversibile che potrebbe 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 |
Consente di visualizzare una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Oggetto Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration. Set-CsMcxConfiguration accetta istanze dell'oggetto McxConfiguration inviate tramite pipeline.
Tipi restituiti
Nessuno. Set-CsMcxConfiguration modifica invece le istanze esistenti dell'oggetto Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsMcxConfiguration -Identity site:Redmond -ExposedWebURL External
Nell'esempio 1 la proprietà ExposedWebURL delle impostazioni di configurazione del servizio per dispositivi mobili per il sito Redmond viene impostata su External.
-------------------------- Esempio 2 --------------------------
Get-CsMcxConfiguration | Set-CsMcxConfiguration -ExposedWebURL External
Nell'esempio 2 viene illustrato in che modo tramite un singolo comando è possibile assegnare la stessa proprietà a tutte le impostazioni di configurazione del servizio per dispositivi mobili attualmente in uso nell'organizzazione. A tale scopo, nel comando viene innanzitutto utilizzato il cmdlet Get-CsMcxConfiguration senza parametri, per restituire una raccolta di tutte le impostazioni di configurazione del servizio per dispositivi mobili esistenti. La raccolta viene quindi inviata tramite pipe a Set-CsMcxConfiguration, che imposta la proprietà ExposedWebURL per ogni elemento della raccolta su External.
-------------------------- Esempio 3 --------------------------
Get-CsMcxConfiguration | Where-Object {$_.SessionShortExpirationInterval -gt 3600} | Set-CsMcxConfiguration -SessionShortExpirationInterval 3600
Nell'esempio precedente tutte le impostazioni di configurazione del servizio per dispositivi mobili con un valore di SessionShortExpirationInterval maggiore di 3600 secondi vengono modificate per impostare il valore della proprietà su 3600. In questo modo, 3600 secondi diventa il valore massimo per tutte le impostazioni di configurazione del servizio per dispositivi mobili nell'organizzazione. A tale scopo, viene innanzitutto chiamato il cmdlet Get-CsMcxConfiguration senza alcun parametro per restituire una raccolta di tutte le impostazioni di configurazione del servizio per dispositivi mobili attualmente in uso. Tale raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che preleva solo le impostazioni in cui la proprietà SessionShortExpirationInterval è maggiore di (-gt) 3600. Questa raccolta filtrata viene quindi inviata tramite pipe a Set-CsMcxConfiguration, che imposta il valore della proprietà SessionShortExpirationInterval per ogni elemento nella raccolta su 3600.