Condividi tramite

  • Articolo

Remove-CsUCPhoneConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di rimuovere la raccolta specificata di impostazioni di configurazione di Microsoft Lync 2010 Phone Edition. Tra queste impostazioni vi sono la modalità di sicurezza richiesta e la possibilità di scegliere se il telefono debba o meno bloccarsi automaticamente dopo un periodo di inattività specifico.

Sintassi

Remove-CsUCPhoneConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Lync 2010 Phone Edition rappresenta l'unione del telefono e di Microsoft Lync 2010. Lync 2010 Phone Edition utilizza un componente hardware speciale (cioè un telefono compatibile con Lync 2010) in grado di funzionare come telefono VoIP. Questo componente hardware può inoltre fungere da endpoint di Lync 2010: è possibile impostare il proprio stato corrente, verificare lo stato dei contatti di Lync 2010, cercare nuovi contatti e svolgere gran parte delle altre attività che solitamente vengono svolte con Lync.

Microsoft Lync Server 2010 è fornito con una serie di cmdlet che consentono di gestire i telefoni Lync 2010. Ad esempio, è possibile controllare aspetti quali la lunghezza minima del PIN utilizzato per accedere al telefono e se il telefono deve bloccarsi automaticamente dopo uno specifico periodo di inattività.

Le impostazioni di configurazione del telefono per le comunicazioni unificate possono essere applicate nell'ambito globale o nell'ambito del sito. Le impostazioni applicate nell'ambito del sito hanno la precedenza su quelle applicate nell'ambito globale. Quando si installa Lync Server 2010, viene creato un unico set di impostazioni di configurazione del telefono per le comunicazioni unificate e questo viene applicato nell'ambito globale. Tuttavia, in qualsiasi momento è possibile utilizzare il cmdlet New-CsUCPhoneConfiguration per creare una raccolta di impostazioni applicate nell'ambito del sito. Ciò consente di personalizzare la gestione dei telefoni UC, in modo da rispondere alle specifiche esigenze di ogni singolo sito.

Le impostazioni create tramite il cmdlet New-CsUCPhoneConfiguration possono successivamente essere rimosse utilizzando il cmdlet Remove-CsUCPhoneConfiguration. Quando queste impostazioni vengono rimosse da un sito, i telefoni con Lync 2010 in quel sito non vengono lasciati privi di gestione; al contrario, vengono automaticamente inclusi nell'ambito delle impostazioni globali.

È anche possibile utilizzare il cmdlet Remove-CsUCPhoneConfiguration per le impostazioni globali. In tal caso, però, le impostazioni globali non vengono effettivamente rimosse: non è possibile rimuovere le impostazioni globali del telefono UC. Ciò che accade è che per le proprietà delle impostazioni globali verranno ripristinati i valori predefiniti. Ad esempio, se l'intervallo di tempo per il blocco del telefono è stato portato a 30 minuti, la "rimozione" delle impostazioni globali ripristinerà l'intervallo di tempo predefinito di 10 minuti.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsUCPhoneConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco della raccolta di impostazioni di configurazione del telefono UC da rimuovere. Per eliminare una raccolta del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond". Per rimuovere (ripristinare) la raccolta globale, utilizzare la seguente sintassi: -Identity global. Si noti che non è consentito utilizzare i caratteri jolly per specificare l'identità di un criterio.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings. Remove-CsUCPhoneConfiguration accetta le istanze dell'oggetto impostazioni telefono per le comunicazioni unificate tramite pipeline.

Tipi restituiti

Nessuno. Il cmdlet rimuove invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

Esempio

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

Remove-CsUCPhoneConfiguration -Identity site:Redmond

Il comando riportato nell'Esempio 1 consente di rimuovere le impostazioni di configurazione del telefono per le comunicazioni unificate per il sito Redmond (-Identity site:Redmond). Quando le impostazioni vengono rimosse dall'ambito di un sito, i telefoni UC degli utenti di quel sito verranno gestiti in base alle impostazioni di configurazione globali.

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

Get-CsUCPhoneConfiguration -Filter site:* | Remove-CsUCPhoneConfiguration

Nell'Esempio 2 vengono rimosse tutte le impostazioni del telefono per le comunicazioni unificate configurate nell'ambito del sito. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsUCPhoneConfiguration e il parametro Filter per ottenere tutte le impostazioni configurate nell'ambito del sito; il valore del filtro "site:*" restituisce solo i dati relativi a quelle impostazioni la cui proprietà Identity inizia con "site:". Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsUCPhoneConfiguration che rimuove ogni elemento nella raccolta.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.EnforcePhoneLock -eq $False} | Remove-CsUCPhoneConfiguration

Nell'Esempio 3 vengono rimosse tutte le impostazioni del telefono per le comunicazioni unificate che impediscono il blocco del telefono. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsUCPhoneConfiguration senza alcun parametro aggiuntivo in modo da ottenere una raccolta di tutte le impostazioni del telefono per le comunicazioni unificate attualmente in uso nell'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle impostazioni in cui la proprietà EnforceLockProperty è uguale a False. Questa raccolta filtrata viene a sua volta inviata tramite pipe al cmdlet Remove-CsUCPhoneConfiguration che rimuove ogni elemento nella raccolta.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -ne "High"} | Remove-CsUCPhoneConfiguration

Il comando precedente consente di eliminare tutte le impostazioni di configurazione del telefono per le comunicazioni unificate per le quali la proprietà SIPSecurityMode è impostata su Low o Medium. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsUCPhoneConfiguration per ottenere una raccolta di tutte le impostazioni del telefono per le comunicazioni unificate configurate per l'utilizzo nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle impostazioni per le quali la proprietà SIPSecurityMode è impostata su Low o Medium; per ottenere questo risultato, selezionare le impostazioni per le quali la proprietà SIPSecurityMode è diversa da High. Ci sono solo tre valori possibili per la proprietà SIPSecurityMode: Low, Medium e High. Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsUCPhoneConfiguration che elimina tutte le impostazioni per le quali la proprietà SIPSecurityMode è diversa da High.