Condividi tramite

  • Articolo

Set-CsCommonAreaPhone

 

Ultima modifica dell'argomento: 2012-03-27

Consente di modificare i valori delle proprietà del telefono nelle aree comuni gestite da Microsoft Lync Server 2010. I telefoni nelle aree comuni sono telefoni posizionati nei corridoi degli edifici, sale di ritrovo o altre posizioni dove possono essere utilizzati da persone diverse e per diversi usi.

Sintassi

Set-CsCommonAreaPhone -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

I telefoni nelle aree comuni sono telefoni IP non associati ad un utente individuale. Invece di essere posizionati in qualche ufficio, i telefoni nelle aree comuni sono generalmente posizionati nei corridoi degli edifici, nelle mense, nelle aree riservate ai dipendenti e in altri luoghi dove è probabile si riuniscano molte persone. Per gli amministratori, questa rappresenta una sfida gestionale; questo perché i telefoni utilizzati in Lync Server 2010 vengono normalmente gestiti utilizzando criteri vocali e dial plan associati a utenti individuali. Ai telefoni nelle aree comuni non viene associato un utente individuale.

Una soluzione a questa sfida è rappresentata dalla creazione di oggetti contatto di Active Directory per tutti i telefoni nelle aree comuni. Questi oggetti contatto possono essere creati usando il cmdlet New-CsCommonAreaPhone. Come nel caso degli account utente, anche a questi oggetti contatto è possibile assegnare criteri e voice plan. Di conseguenza, sarà possibile mantenere il controllo dei telefoni nelle aree comuni anche se non sono associati a singoli utenti. Ad esempio, se si desidera evitare che le persone possano trasferire o parcheggiare le chiamate da un telefono in un'area comune, è possibile creare un criterio vocale che impedisca il trasferimento o il parcheggio delle chiamate e quindi assegnare questo criterio ai telefoni nelle aree comuni (oppure, più correttamente, all'oggetto contatto che rappresenta il telefono nell'area comune). Questo comando assegna il criterio vocale CommonAreaPhoneVoicePolicy a tutti i telefoni nelle aree comuni:

Get-CsCommonAreaPhone | Grant-CsVoicePolicy –PolicyName "CommonAreaPhoneVoicePolicy"

Il cmdlet Set-CsCommonAreaPhone consente di modificare le proprietà degli oggetti contatto associati ai telefoni delle aree comuni. Tra l'altro, è possibile cambiare il nome visualizzato del contatto di Active Directory e anche l'URI linea associato al telefono. È anche possibile utilizzare il parametro Enabled per abilitare e disabilitare l'account per l'utilizzo con Lync Server 2010.

È inoltre possibile configurare l'hotdesking per telefoni di area comune utilizzando i cmdlet CsClientPolicy. Con un telefono di tipo Hot Desk, gli utenti possono accedere al telefono utilizzando le credenziali di Lync Server. In questo modo, possono accedere in modo semplice ai contatti. Per ulteriori informazioni, vedere l'argomento della Guida relativo al cmdlet Set-CsClientPolicy.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsCommonAreaPhone può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins. Il permesso di eseguire questo cmdlet per siti specifici o specifiche unità organizzative di Active Directory (OU) può essere assegnato utilizzando il cmdlet Grant-CsOUPermission. 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 "Set-CsCommonAreaPhone"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Parametro User ID

Identificatore univoco per il telefono dell'area comune. I telefoni delle aree comuni vengono identificati tramite il nome distinto di Active Directory dell'oggetto contatto associato. Per impostazione predefinita, i telefoni delle aree comuni utilizzano un identificatore univoco globale (GUID) come nome comune; i telefoni avranno quindi un parametro Identity analogo al seguente: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Pertanto, potrebbe risultare più semplice recuperare i telefoni delle aree comuni utilizzando il cmdlet Get-CsCommonAreaPhone, inviando poi tramite pipe gli oggetti restituiti al cmdlet Set-CsCommonAreaPhone.

Enabled

Facoltativo

Stringa

Indica se l'oggetto contatto per il telefono dell'area comune è stato abilitato o meno per Lync Server 2010.

Se si disabilita un contatto utilizzando il parametro Enabled, le informazioni associate a tale account (compresi i criteri assegnati e l'abilitazione del contatto per VoIP aziendale, il controllo delle chiamate remote e/o l'integrazione della segreteria telefonica) vengono mantenute. Se in seguito si riabilita l'account utilizzando il parametro Enabled, le informazioni sull'account associate vengono ripristinate.

Description

Facoltativo

Stringa

Consente di modificare l'attributo della descrizione di Active Directory per il telefono dell'area comune. Ciò consente di fornire ulteriori informazioni relative al telefono: ad esempio, potrebbe essere opportuno fornire dettagli su chi contattare in caso di problemi con l'apparecchio.

DisplayName

Facoltativo

Stringa

Consente di modificare il nome visualizzato di Active Directory per il telefono dell'area comune.

DisplayNumber

Facoltativo

Stringa

Numero telefonico come viene visualizzato in Microsoft Lync 2010. La proprietà DisplayNumber può essere formattata in qualsiasi modo; ad esempio, 1-800-555-1234, 1-(800)-555-1234, 1.800.555.1234 e così via. Quando si sceglie un numero da visualizzare, tenere presente che quel numero verrà visualizzato sullo schermo di un telefono nelle aree comuni solo se il numero può essere normalizzato. La normalizzazione è il procedimento di conversione delle stringhe di numeri nel formato standard dei numeri telefonici. Se non esiste una regola di normalizzazione per il formato del numero telefonico utilizzato nella configurazione del numero da visualizzare, sullo schermo del telefono nell'area comune comparirà il valore della proprietà LineUri invece del valore della proprietà DisplayNumber.

DomainController

Facoltativo

Stringa

Consente la connessione al controller di dominio specificato per modificare le informazioni sul contatto. Per la connessione a uno specifico controller di dominio, includere il parametro DomainController seguito dal nome computer (ad esempio atl-mcs-001) o dal suo nome di dominio completo (FQDN) ad esempio: atl-mcs-001.litwareinc.com.

EnterpriseVoiceEnabled

Facoltativo

Booleano

Indica se l'oggetto contatto del telefono dell'area comune è stato abilitato per VoIP aziendale, la soluzione Voice over Internet Protocol (VoIP) offerta da Microsoft. Con VoIP aziendale, è possibile effettuare chiamate via Internet anziché utilizzare la rete telefonica standard.

LineUri

Facoltativo

Stringa

Numero di telefono per il telefono nell'area comune. L'URI di linea deve essere specificato utilizzando il formato E.164 e il prefisso "TEL:". Ad esempio: TEL:+14255551297. Qualsiasi numero di interno deve essere aggiunto alla fine dell'URI di linea, ad esempio: TEL:+14255551297;ext=51297.

SipAddress

Facoltativo

Indirizzo SIP

Identificatore univoco che consente al telefono in un'area comune di comunicare con i dispositivi SIP come, ad esempio, Lync 2010. L'indirizzo SIP deve essere preceduto dal prefisso sip: e includere un dominio SIP valido. Ad esempio: sip:bldg14lobby@litwareinc.com.

PassThru

Facoltativo

Parametro opzionale

Restituisce un oggetto che rappresenta il telefono nell'area comune.

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.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Tipi restituiti

Per impostazione predefinita il cmdlet Set-CsCommonAreaPhone non restituisce oggetti o valori. Tuttavia, se si include il parametro PassThru, il cmdlet restituirà le istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Esempio

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

Get-CsCommonAreaPhone -Filter {LineUri -eq "tel:+14255556710"} | Set-CsCommonAreaPhone -DisplayName "Employee Lounge"

Nell'Esempio 1 si modifica il nome visualizzato di Active Directory per il telefono dell'area comune con il numero 1-425-555-6710. Per eseguire questa operazione, si utilizza per primo il cmdlet Get-CsCommonAreaPhone insieme al parametro Filter; il valore filtro {LineUri -eq "tel:+14255556710"} limita il numero di dati restituiti al telefono dell'area comune in cui la proprietà LineUri è uguale a +14255556710. L'oggetto restituito viene quindi inviato tramite pipe al cmdlet Set-CsCommonAreaPhone che imposta il valore della proprietà DisplayName su "Employee Lounge".

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

Get-CsCommonAreaPhone | Set-CsCommonAreaPhone -Enabled $True

Il comando nell'Esempio 2 abilita tutti i telefoni delle aree comuni attualmente configurati per l'utilizzo all'interno dell'organizzazione. Per eseguire questa operazione, il comando utilizza il cmdlet Get-CsCommonAreaPhone senza alcun parametro aggiuntivo per ottenere una raccolta di tutti i telefoni nelle aree comuni. Questa raccolta viene quindi inviata tramite pipe al cmdlet Set-CsCommonAreaPhone che imposta la proprietà Enabled su True per ogni elemento nella raccolta.

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

Get-CsCommonAreaPhone -Filter {Description -eq $Null} | Set-CsCommonAreaPhone -Description "Common area phone"

Il comando precedente aggiunge una descrizione generica a tutti i telefoni delle aree comuni che non dispongono di un valore assegnato alla proprietà Description. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsCommonAreaPhone con il parametro Filter; il valore del filtro {Description -eq $Null} restituisce solo i telefoni nelle aree comuni in cui la proprietà Description è uguale a un valore Null. Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Set-CsCommonAreaPhone che assegna la descrizione generica "Common area phone" a ogni elemento nella raccolta.