• Articolo

Set-CsExUmContact

 

Ultima modifica dell'argomento: 2012-03-25

Modifica un oggetto contatto Operatore automatico o Accesso sottoscrittore esistente per Messaggistica unificata di Exchange ospitato.

Sintassi

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

Descrizione dettagliata

Microsoft Lync Server 2010 collabora con Messaggistica unificata di Exchange per fornire diverse funzionalità vocali, tra cui Operatore automatico e Accesso sottoscrittore. Quando Messaggistica unificata di Exchange viene fornito come servizio ospitato (anziché locale), è necessario creare oggetti contatto mediante Windows PowerShell per applicare le funzionalità Operatore automatico e Accesso sottoscrittore. Questi oggetti sono creati tramite il cmdlet New-CsExUmContact e possono essere successivamente modificati utilizzando il cmdlet Set-CsExUmContact.

Il modo più semplice per utilizzare questo cmdlet consiste spesso nel chiamare per prima cosa Get-CsExUmContact per recuperare un'istanza dell'oggetto contatto che si desidera modificare. È sufficiente inviare tramite pipe l'output del comando Get-CsExUmContact al cmdlet Set-CsExUmContact e assegnare i valori ai parametri delle proprietà che si intende modificare. Per informazioni dettagliate, vedere la sezione relativa agli esempi in questo argomento. In alternativa, è possibile chiamare il cmdlet Set-CsExUmContact, passando il parametro Identity dell'oggetto contatto che si desidera modificare.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsExUmContact i membri dei seguenti gruppi: RTCUniversalUserAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

UserIDParameter

L'identificatore univoco dell'oggetto contatto che si desidera modificare. Le identità dei contatti possono essere specificate utilizzando uno dei quattro formati seguenti: 1) L'indirizzo SIP del contatto; 2) il nome dell'entità utente (UPN) del contatto; 3) il nome del dominio del contatto e il nome di accesso nella forma dominio\accesso (ad esempio, litwareinc\exum1); infine, 4) il nome di visualizzazione Active Directory del contatto (ad esempio, Team Auto Attendant).

Tipo di dati completi: Microsoft.Rtc.Management.AD.UserIdParameter

AutoAttendant

Facoltativo

Booleano

Impostare il parametro su True se l'oggetto contatto è un Operatore automatico. Questo parametro è False per impostazione predefinita.

Description

Facoltativo

Stringa

Una descrizione del contatto. La descrizione consente agli amministratori di identificare il tipo di contatto (Operatore automatico o Accesso sottoscrittore), l'ubicazione, il provider o qualsiasi altra informazione che identifichi lo scopo di ciascun contatto Messaggistica unificata di Exchange.

DisplayNumber

Facoltativo

Stringa

Il numero di telefono del contatto. I numeri visualizzati per ogni contatto devono essere univoci (ovvero due contatti di Messaggistica unificata di Exchange non possono avere lo stesso numero visualizzato). La modifica del valore non modifica il valore della proprietà LineURI.

Questo valore può iniziare con un segno più (+) e può contenere qualsiasi numero di cifre. La prima cifra non può essere uno zero.

Enabled

Facoltativo

Booleano

Indica se il contatto è stato abilitato per Lync Server 2010. L'impostazione di questo parametro su False disabiliterà il contatto e l'Operatore automatico o l'accesso sottoscrittore associato con il contatto smetterà di funzionare.

Se si disabilita un account utilizzando il parametro Enabled, le informazioni associate a questo account (compresi i criteri segreteria telefonica ospitati assegnati) verranno mantenute. Se l'account viene riabilitato nuovamente utilizzando il parametro Enable, le informazioni associate all'account verranno ripristinate.

EnterpriseVoiceEnabled

Facoltativo

Booleano

Indica se il contatto è stato abilitato per VoIP aziendale. Se il valore è impostato su False, le funzionalità Operatore automatico o accesso sottoscrittore associate a questo contatto non saranno più disponibili.

SipAddress

Facoltativo

Stringa

L'indirizzo SIP del contatto. Deve essere un nuovo indirizzo che non è già esistente come utente o contatto in Servizi di dominio Active Directory.

La modifica di questo valore non comporterà la modifica dell'indirizzo SIP archiviato nella proprietà OtherIpPhone.

È possibile utilizzare SipAddress come valore Identity per i comandi Get-CsExUmContact per recuperare contatti specifici. Quando si chiama questo cmdlet, verrà utilizzato il nuovo indirizzo SIP. Le query sull'indirizzo SIP precedente non restituiranno alcun oggetto.

DomainController

Facoltativo

FQDN

Consente di specificare un controller di dominio. Se non è specificato alcun controller di dominio, verrà utilizzato il primo disponibile.

PassThru

Facoltativo

Parametro opzionale

Restituisce i risultati del comando. Per impostazione predefinita, il cmdlet non genera alcun output.

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.OCSADExUmContact. Accetta l'input da pipeline di oggetti contatto di Messaggistica unificata di Exchange.

Tipi restituiti

Questo cmdlet modifica un oggetto di tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact. Se viene utilizzato il parametro PassThru, viene restituito anche un oggetto di questo tipo.

Esempio

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

Get-CsExUmContact -Identity sip:exumsa4@fabrikam.com | Set-CsExUmContact -AutoAttendant $True

Questo esempio imposta la proprietà AutoAttendant del contatto Messaggistica unificata di Exchange con l'indirizzo SIP exumsa4@fabrikam.com su True. Come prima cosa viene richiamato l'oggetto Get-CsExUmContact per recuperare l'oggetto contatto. (Si sarebbe potuto utilizzare il nome visualizzato in Servizi di dominio Active Directory del contatto, il nome principale del contatto utente o il nome di accesso del contatto.) Questo comando recupera il contatto con il parametro Identity fornito. Il contatto viene quindi inviato tramite pipe al cmdlet Set-CsExUmContact, dove viene impostato il parametro AutoAttendant su True.

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

Set-CsExUmContact -Identity "CN={1bf6208d-2847-45d0-828f-636f14da858b},OU=ExUmContacts,DC=litwareinc,DC=com" -AutoAttendant $True

Questo esempio è identico all'esempio 1, ma al posto di recuperare il contatto tramite Get-CsExUmContact e inviare tramite pipe l'oggetto su Set-CsExUmContact, viene fornito il cmdlet Set-CsExUmContact con il valore Identity del contatto che si desidera modificare. Si noti il formato del parametro Identity: in questo caso, è stato utilizzato il nome distinto completo dell'oggetto contatto che include un GUID generato automaticamente (ovvero al momento della creazione del contatto). Viene quindi impostato il parametro AutoAttendant del contatto su True.