Condividi tramite

  • Articolo

New-CsUCPhoneConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Crea una nuova raccolta di impostazioni utilizzate per gestire Microsoft Lync 2010 Phone Edition. Queste impostazioni consentono di configurare elementi quali la modalità di protezione richiesta e di specificare se il telefono deve essere bloccato automaticamente dopo uno specifico periodo di inattività.

Sintassi

New-CsUCPhoneConfiguration -Identity <XdsIdentity> [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-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, ovvero un telefono compatibile con Lync 2010, in grado di funzionare come telefono VoIP (Voice over IP). Questo componente hardware può inoltre fungere da endpoint di Lync 2010: è possibile impostare lo stato corrente, verificare lo stato dei contatti di Lync 2010, cercare nuovi contatti e svolgere gran parte delle altre attività che solitamente vengono eseguite con Lync 2010.

Lync Server 2010 è fornito di 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 all'ambito del sito hanno la precedenza rispetto a quelle applicate all'ambito globale. Quando si installa inizialmente Lync Server, viene creato un singolo set di impostazioni di configurazione del telefono per le comunicazioni unificate e viene applicato all'ambito globale. Tuttavia, in qualsiasi momento è possibile utilizzare il cmdlet New-CsUCPhoneConfiguration per creare una raccolta di impostazioni applicate nell'ambito del sito. In questo modo la gestione del telefono per le comunicazioni unificate può essere adattata alle esigenze specifiche di ogni singolo sito.

New-CsUCPhoneConfiguration consente di creare nuove impostazioni del telefono UC nell'ambito del sito. Può esistere una sola raccolta di impostazioni per sito. Per esempio, si supponga di creare una raccolta di impostazioni con identità site:Redmond e che al sito Redmond sia già assegnato un set di impostazioni del telefono UC. In tal caso, il comando avrà esito negativo. In realtà, è necessario eseguire un'operazione tra due: rimuovere le impostazioni esistenti e poi utilizzare New-CsUCPhoneConfiguration per creare una nuova raccolta di impostazioni, oppure utilizzare semplicemente Set-CsUCPhoneConfiguration per modificare le impostazioni esistenti.

Non è possibile creare una nuova raccolta di impostazioni nell'ambito globale. In realtà, l'unica operazione che si può eseguire nell'ambito globale è utilizzare Set-CsUCPhoneConfiguration per modificare le impostazioni esistenti.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsUCPhoneConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Rappresenta l'identificatore univoco da assegnare alla nuova raccolta di impostazioni di configurazione del telefono per le comunicazioni unificate. Poiché è possibile creare nuove raccolte solo nell'ambito del sito, l'identità avrà sempre il prefisso "site:" seguito dal nome del sito, come, ad esempio, "site:Redmond".

CalendarPollInterval

Facoltativo

TimeSpan

Indica con quale frequenza il dispositivo per le comunicazioni unificate recupera informazioni dal calendario di Microsoft Outlook. Il valore deve essere specificato utilizzando il formato ore:minuti:secondi; ad esempio, per impostare l'intervallo di tempo su 1 ora, ovvero l'intervallo massimo consentito, utilizzare la sintassi seguente: -CalendarPollInterval "01:00:00". Il valore predefinito è 3 minuti (00:03:00).

EnforcePhoneLock

Facoltativo

Booleano

Consente di determinare se i telefoni per le comunicazioni unificate vengono bloccati automaticamente dopo il numero di minuti specificato da PhoneLockTimeout. Il valore predefinito è True.

LoggingLevel

Facoltativo

Stringa

Consente la registrazione sul dispositivo UC. I valori validi sono Disattivato, Basso, Medio e Alto. Il valore predefinito è Disattivato.

MinPhonePinLength

Facoltativo

Byte

Specifica il numero minimo di cifre richiesto per i PIN (Personal Identification Number).

Valore minimo: 4

Valore massimo: 15

Valore predefinito: 6

PhoneLockTimeout

Facoltativo

Timespan

Specifica il periodo di tempo, in minuti, in cui un telefono per le comunicazioni unificate può restare inattivo prima che venga automaticamente attivato il blocco.

Il valore deve essere inferiore a 01:00:00 (1 ora). Il valore predefinito è 00:10:00 (10 minuti).

SIPSecurityMode

Facoltativo

SIPSecurityMode

Specifica il livello di sicurezza che il server applica alle sessioni SIP avviate mediante un telefono per le comunicazioni unificate.

I valori validi sono:

Bassa (consente qualsiasi tipo di autorizzazione o trasporto).

Media (è necessario NTLM o Kerberos per l'autenticazione degli utenti).

Alta (è necessario NTLM o Kerberos per l'autenticazione degli utenti e TLS per le connessioni SIP).

Il valore predefinito è High.

Voice8021p

Facoltativo

Byte

Specifica il valore della priorità utente (il valore 802.1p) per il traffico vocale nella distribuzione di Lync Server 2010.

Questa impostazione viene applicata solo alle reti in cui gli switch e i bridge supportano lo standard 802.1p. Il valore minimo per questa proprietà è 0 e il valore massimo è 7. Il valore predefinito è 0.

VoiceDiffServTag

Facoltativo

Byte

Specifica la rappresentazione decimale dell'indicazione di priorità DSCP (DiffServ Code Point) a 6 bit, che definisce l'opzione PHB (Per Hop Behavior) per i pacchetti IP passati dai telefoni per le comunicazioni unificate gestiti da questo server.

Questo valore deve essere compreso tra 0 e 63, inclusi. Il valore predefinito è 40.

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.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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

Nessuno. New-CsUCPhoneConfiguration non accetta l'input da pipeline.

Tipi restituiti

Il cmdlet crea istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

Esempio

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

New-CsUCPhoneConfiguration -Identity site:Redmond -CalendarPollInterval "00:10:00" -LoggingLevel "Medium"

Con il comando precedente viene creata una nuova raccolta di impostazioni del telefono UC per il sito Redmond. In questo esempio, sono inclusi due parametri opzionali insieme al parametro obbligatorio Identity: CalendarPollInterval, che imposta il tempo di polling del calendario su 10 minuti (00 ore: 10 minuti: 00 secondi), e LoggingLevel, che imposta il livello di registrazione del telefono UC su Medium. Non appena viene completato il comando, vengono applicate le nuove impostazioni al sito Redmond e i telefoni UC degli utenti in quel sito saranno governati dalle nuove impostazioni. Questo comando avrà esito negativo se il sito Redmond contiene già una raccolta di impostazioni del telefono UC.

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

$x = New-CsUCPhoneConfiguration -Identity site:Redmond -InMemory
$x.CalendarPollInterval = "00:10:00" 
$x.LoggingLevel = "Medium"
Set-CsUCPhoneConfiguration -Instance $x

Con l'esempio 2 viene dimostrato l'uso del parametro InMemory, che consente di creare un nuovo set di impostazioni del telefono UC esistenti solo in memoria. Queste impostazioni vengono memorizzate nella variabile $x. Dopo la creazione di questa raccolta virtuale è possibile modificare le impostazioni solo in memoria utilizzando comandi simili a quelli mostrati nelle righe 2 e 3 dell'esempio: nella riga 2, la proprietà CalendarPollInterval viene impostata su 10 minuti (00 ore: 10 minuti: 00 secondi), mentre nella riga 3 la proprietà LoggingLevel viene impostata su Medium.

Una volta completata la modifica dei valori delle proprietà, è possibile utilizzare Set-CsUCPhoneConfiguration per trasformare le impostazioni virtuali archiviate in $x in una raccolta effettiva di impostazioni applicate al sito Redmond. Con l'uso del parametro InMemory, le impostazioni non vengono applicate fino alla chiamata a Set-CsUCPhoneConfiguration. Se questo cmdlet non viene chiamato, le impostazioni virtuali scompaiono quando si termina la sessione di Windows PowerShell o se si elimina la variabile $x.