Remove-CsMcxConfiguration

 

Ultima modifica dell'argomento: 2012-04-23

Rimuove la 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

Remove-CsMcxConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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.

Quando si installa Lync Server 2010, viene creata una singola raccolta di impostazioni di configurazione del servizio per dispositivi mobili nell'ambito globale. Gli amministratori possono tuttavia creare impostazioni di configurazione personalizzate nell'ambito del sito o del servizio. Queste impostazioni personalizzate possono successivamente essere rimosse utilizzando il cmdlet Remove-CsMcxConfiguration. Se si rimuovono le impostazioni del servizio, i server dei servizi per dispositivi mobili precedentemente gestiti da tali impostazioni verranno gestiti dalle impostazioni del sito, se disponibili, oppure dalle impostazioni globali. Se si rimuovono le impostazioni del sito, i server verranno gestiti dalle impostazioni globali.

Si noti che è anche possibile eseguire il cmdlet Remove-CsMcxConfiguration sulle impostazioni globali. In tal caso, tuttavia, le impostazioni globali non verranno rimosse, ma verranno semplicemente ripristinati i valori predefiniti delle proprietà incluse nella raccolta globale.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsMcxConfiguration i membri dei gruppi seguenti: RTCUniversalServerAdmins.

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
Identity	Obbligatorio	XdsIdentity	Identificatore univoco delle impostazioni di configurazione del servizio per dispositivi mobili da rimuovere. Per "rimuovere" le impostazioni globali, utilizzare la sintassi seguente: -Identity global Si noti che non è possibile rimuovere realmente le impostazioni globali, ma solo ripristinare i valori predefiniti delle proprietà. Per rimuovere le impostazioni dall'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond Per rimuovere le impostazioni configurate nell'ambito del servizio, utilizzare una sintassi simile alla seguente: -Identity service:WebServer:atl-cs-001.litwareinc.com Non è possibile utilizzare caratteri jolly per specificare il parametro Identity.
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

Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration. Remove-CsMcxConfiguration accetta input inviato tramite pipeline di oggetti McxConfiguration.

Tipi restituiti

Nessuno. Il cmdlet elimina istanze dell'oggetto Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration.

Esempio

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

Remove-CsMcxConfiguration -Identity "site:Redmond"

Il comando illustrato nell'esempio 1 consente di eliminare la raccolta di impostazioni di configurazione del servizio per dispositivi mobili assegnate al sito Redmond.

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

Get-CsMcxConfiguration -Filter "service:*" | Remove-CsMcxConfiguration

Nell'esempio 2 tutte le impostazioni di configurazione del servizio per dispositivi mobili assegnate all'ambito del servizio vengono rimosse. A tale scopo, viene utilizzato il cmdlet Get-CsMcxConfiguration insieme al parametro Filter. Il valore di filtro "service:*" garantisce che vengano restituite solo le impostazioni con un parametro Identity che inizia con il valore stringa "service:". Tale raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsMcxConfiguration, che provvede alla sua eliminazione.

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

Get-CsMcxConfiguration | Where-Object {$_.ExposedWebURL -eq "Internal"} | Remove-CsMcxConfiguration

Il comando precedente consente di eliminare tutte le impostazioni di configurazione del servizio per dispositivi mobili in cui la proprietà ExposedWebURL è stata impostata su Internal. A tale scopo, nel comando viene innanzitutto chiamato Get-CsMcxConfiguration senza alcun parametro. In questo modo viene restituita una raccolta di tutte le impostazioni di configurazione del servizio per dispositivi mobili attualmente in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che preleva solo le impostazioni in cui ExposedWebURL è uguale a (-eq) Internal. La raccolta filtrata viene a sua volta inviata tramite pipe al cmdlet Remove-CsMcxConfiguration, che elimina ogni elemento di tale raccolta.

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

Get-CsMcxConfiguration | Where-Object {$_.PushNotificationProxyUri -eq $Null} | Remove-CsMcxConfiguration

Nell'esempio 4 tutte le impostazioni di configurazione del servizio per dispositivi mobili a cui non è assegnato un URI proxy di notifica Push vengono rimosse da Lync Server. A tale scopo, nel comando viene prima utilizzato Get-CsMcxConfiguration (senza alcun parametro) per restituire una raccolta di tutte le impostazioni di configurazione del servizio per dispositivi mobili attualmente in uso. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che preleva le impostazioni la cui proprietà PushNotificationProxyUri è uguale a (-eq) un valore Null. La impostazioni che soddisfano questo criterio vengono quindi inviate tramite pipe al cmdlet Remove-CsMcxConfiguration, che provvede alla loro eliminazione.