Condividi tramite

  • Articolo

Set-CsUCPhoneConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di modificare le opzioni di gestione per Microsoft Lync 2010 Phone Edition. Tali opzioni includono aspetti quali la modalità di protezione richiesta o se il telefono deve bloccarsi automaticamente dopo uno specifico periodo di inattività.

Sintassi

Set-CsUCPhoneConfiguration [-Identity <XdsIdentity>] [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-WhatIf [<SwitchParameter>]]

Set-CsUCPhoneConfiguration [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 Internet Protocol). 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 svolte con Lync 2010.

I cmdlet CsUCPhoneConfiguration consentono di gestire le impostazioni di configurazione dei telefoni che eseguono Lync 2010 Phone Edition. Ad esempio, è possibile controllare aspetti quali la lunghezza minima del PIN (Personal Identification Number) utilizzato per accedere al telefono e se il telefono deve bloccarsi automaticamente dopo uno specifico intervallo di tempo.

Le impostazioni di configurazione del telefono per le comunicazioni unificate possono essere applicate all'ambito globale o all'ambito del sito. 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 all'ambito del sito. In questo modo la gestione del telefono per le comunicazioni unificate può essere adattata alle esigenze specifiche di ogni singolo sito.

Oltre a creare nuove raccolte di impostazioni del telefono per le comunicazioni unificate, è possibile utilizzare il cmdlet Set-CsUCPhoneConfiguration per modificare i valori delle proprietà per una raccolta esistente. Ad esempio, la registrazione è disabilitata per impostazione predefinita per i telefoni per le comunicazioni unificate. Per abilitare la registrazione a livello globale, è possibile utilizzare Set-CsUCPhoneConfiguration per modificare il valore della proprietà LoggingLevel della raccolta globale su True.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Set-CsUCPhoneConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Rappresenta l'identificatore univoco assegnato alla raccolta di impostazioni di configurazione del telefono per le comunicazioni unificate. Utilizzare la sintassi di seguito per fare riferimento alle impostazioni globali: -Identity global. Per fare riferimento a una raccolta configurata nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Non è possibile utilizzare caratteri jolly per specificare un'identità.

Se questo parametro viene omesso, Set-CsUCPhoneConfiguration modificherà le impostazioni globali.

Instance

Facoltativo

Oggetto UcPhoneSettings

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

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 nel dispositivo per le comunicazioni unificate. 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.

Questa impostazione viene applicata solo nelle reti in cui i commutatori 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.

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. Set-CsUCPhoneConfiguration accetta istanze inviate tramite pipe dell'oggetto delle impostazioni del telefono per le comunicazioni unificate.

Tipi restituiti

Set-CsUCPhoneConfiguration non restituisce un valore o un oggetto. Il cmdlet configura invece istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

Esempio

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

Set-CsUCPhoneConfiguration -Identity global -SIPSecurityMode "Medium"

Con il comando mostrato nell'esempio 1 si imposta la modalità di protezione SIP delle impostazioni globali del telefono per le comunicazioni unificate su Medio.

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

Set-CsUCPhoneConfiguration -Identity site:Redmond -PhoneLockTimeout "00:30:00"

Con il comando precedente si modificano le impostazioni del telefono per le comunicazioni unificate per il sito di Redmond. In questo caso, la proprietà PhoneLockTimeout viene impostata su 30 minuti includendo il parametro PhoneLockTimeout e il valore di parametro "00:30:00" (00 ore: 30 minuti: 00 secondi).

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

Get-CsUCPhoneConfiguration -Filter "site:*" | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:30:00"

L'esempio 3 rappresenta una variazione del comando mostrato nell'esempio 2. In questo caso, tuttavia, la proprietà PhoneLockTimeout viene modificata per tutte le impostazioni del telefono per le comunicazioni unificate configurate nell'ambito del sito. Per questo scopo, viene inizialmente chiamato Get-CsUCPhoneConfiguration. Il parametro Filter e il valore del filtro "site:*" limitano i dati restituiti alle impostazioni del telefono configurate nell'ambito del sito. Questa raccolta filtrata viene quindi inviata tramite pipe a Set-CsUCPhoneConfiguration, che utilizza il parametro PhoneLockTimeout e il valore di parametro "00:30:00" (00 ore: 30 minuti: 00 secondi) per impostare il valore di timeout per il blocco del telefono per ogni elemento della raccolta su 30 minuti.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -ne "High"} | Set-CsUCPhoneConfiguration -EnforcePhoneLock $True -PhoneLockTimeout "00:30:00"

Con il comando precedente si configurano le proprietà EnforcePhoneLock e PhoneLockTimeout per tutte le impostazioni del telefono per le comunicazioni unificate in cui la modalità di sicurezza SIP è impostata su Bassa o Media. Per eseguire questa attività, viene prima utilizzato Get-CsUCPhoneConfiguration per restituire tutte le impostazioni del telefono per le comunicazioni unificate nell'organizzazione. Queste informazioni vengono quindi inviate tramite pipe al cmdlet Where-Object che utilizza solo le impostazioni in cui la proprietà SIPSecurityMode è diversa da Alta. Poiché la sicurezza SIP può essere impostata solo su Bassa, Media o Alta, questa clausola selezionerà tutte le impostazioni in cui SIPSecurityMode è impostato su Bassa o Media. La raccolta filtrata viene quindi inviata tramite pipe a Set-CsUCPhoneConfiguration, che utilizza i parametri EnforcePhoneLock e PhoneLockTimeout per modificare le proprietà di blocco del telefono e di timeout per il blocco.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.PhoneLockTimeout -lt "00:10:00"} | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:10:00"

Nell'esempio 5, il valore di timeout per il blocco del telefono è impostato su 10 minuti per tutte le impostazioni del telefono per le comunicazioni unificate in cui la proprietà PhoneLockTimeout ha un valore inferiore a 10 minuti. In questo modo, il valore di 10 minuti diventa il timeout minimo per il blocco del telefono in tutta l'organizzazione. Per questo scopo, viene prima utilizzato Get-CsUCPhoneConfiguration per restituire una raccolta di tutte le impostazioni del telefono per le comunicazioni unificate in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe a Where-Object, che sceglie solo le impostazioni in cui la proprietà PhoneLockTimeout è inferiore a 10 minuti (00 ore: 10 minuti: 00 secondi). La raccolta filtrata viene quindi inviata tramite pipe a Set-CsUCPhoneConfiguration, che imposta il valore PhoneLockTimeout per ogni elemento della raccolta su 10 minuti.