Condividi tramite

  • Articolo

Get-CsUCPhoneConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sulle opzioni di gestione disponibili per Microsoft Lync 2010 Phone Edition. Tra queste vi sono la modalità di sicurezza e la possibilità di scegliere se il telefono debba o meno bloccarsi dopo un dato periodo di inattività.

Sintassi

Get-CsUCPhoneConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsUCPhoneConfiguration [-Filter <String>] [-LocalStore <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 2010.

I cmdlet CsUCPhoneConfiguration consentono di gestire i propri telefoni di Lync 2010. È ad esempio possibile controllare la lunghezza minima del PIN (Personal Identification Number) utilizzato per accedere al telefono oppure se il telefono si bloccherà automaticamente dopo un tempo di inattività specificato.

Le impostazioni di configurazione dei telefoni possono essere applicate nell'ambito globale o a livello di sito. Le impostazioni applicate a livello di sito hanno la precedenza su quelle applicate nell'ambito globale. Il cmdlet Get-CsUCPhoneConfiguration consente di recuperare le informazioni sulle impostazioni correnti dei telefoni nell'organizzazione.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsUCPhoneConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, 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 "Get-CsUCPhoneConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Indica l'identificatore univoco della raccolta di impostazioni di configurazione dei telefoni UC (unified communications) che si desidera ottenere. Per ottenere le impostazioni globali, utilizzare la seguente sintassi: -Identity global. Per ottenere una raccolta configurata nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond". Si noti che non è consentito utilizzare i caratteri jolly per specificare l'identità (Identity). Se si desidera utilizzare i caratteri jolly, includere il parametro Filter.

Se questo parametro non viene specificato, il cmdlet Get-CsUCPhoneConfiguration restituirà una raccolta di tutte le impostazioni di configurazione dei telefoni UC utilizzate nell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per ottenere una o più raccolte di impostazioni di configurazione dei telefoni UC. Ad esempio, per ottenere una raccolta di tutte le impostazioni configurate nell'ambito del sito, utilizzare la seguente sintassi: -Filter site:*. Per restituire una raccolta di tutte le impostazioni che contengono il valore stringa "EMEA" in Identity (l'unica proprietà su cui è possibile applicare il filtro), utilizzare la sintassi riportata di seguito: -Filter *EMEA*.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati di configurazione dei telefoni UC dalla copia locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno. Get-CsUCPhoneConfiguration non accetta input tramite pipeline.

Tipi restituiti

Get-CsUCPhoneConfiguration restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

Esempio

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

Get-CsUCPhoneConfiguration

Il comando riportato nell'Esempio 1 restituisce tutte le impostazioni di configurazione dei telefoni UC attualmente in uso nell'organizzazione. L'esecuzione di Get-CsUCPhoneConfiguration senza ulteriori parametri restituisce sempre la raccolta completa delle impostazioni di configurazione del telefono.

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

Get-CsUCPhoneConfiguration -Identity site:Redmond

Nell'Esempio 2, vengono restituite solo le impostazioni di configurazione dei telefoni UC con Identity site:Redmond. Dal momento che i valori per l'identità (Identity) devono essere univoci, questo comando non restituirà mai più di una raccolta di impostazioni di configurazione del telefono.

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

Get-CsUCPhoneConfiguration -Filter site:*

Nel comando precedente, vengono restituite tutte le impostazioni dei telefoni UC configurate nell'ambito del sito. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsUCPhoneConfiguration insieme al parametro Filter; il valore del filtro "site:*" restituisce solo i dati relativi alle impostazioni in cui la proprietà Identity (l'unica che è possibile filtrare) inizia con la stringa "site:". Per definizione, qualsiasi impostazione in cui la proprietà Identity inizia con la stringa "site:" è stata configurata nell'ambito del sito.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -eq "Medium"}

Nell'Esempio 4, vengono restituite le impostazioni di configurazione dei telefoni UC in cui la modalità di sicurezza SIP è impostata su Media. La sicurezza SIP può essere impostata su Bassa, Media o Avanzata. 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 quei criteri in cui la proprietà SIPSecurityMode è uguale a Medium.

-------------------------- Esempio 5 --------------------------

Get-CsUCPhoneConfiguration | Where-Object {$_.EnforcePhoneLock -eq $False -or $_.MinPhonePinLength -lt 6}

Nell'Esempio 5, vengono restituite le impostazioni dei telefoni che soddisfano almeno uno dei seguenti criteri: 1) non viene applicato il blocco del telefono e/o 2) la lunghezza minima del codice PIN è di 6 cifre. Per questo scopo, viene prima utilizzato Get-CsUCPhoneConfiguration per restituire una raccolta di tutte le impostazioni del telefono UC in uso nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo gli elementi che soddisfano almeno uno dei seguenti criteri: 1) la proprietà EnforcePhoneLock è uguale a False e/o 2) la proprietà MinPhoneLength è minore di 6.

L'operatore -or indica al cmdlet Where-Object che deve selezionare gli elementi che soddisfano uno o entrambi i criteri. Per selezionare le impostazioni che soddisfano entrambi i criteri (in questo caso, quelli in cui non si applica il blocco del telefono e la lunghezza del codice PIN è inferiore a 6), utilizzare l'operatore -and:

Where-Object {$_.EnforcePhoneLock -eq $False -and $_.MinPhonePinLength -lt 6}