Set-Contact (RTM)

Articolo
08/07/2014

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-17

Il cmdlet Set-Contact consente di modificare le impostazioni di un contatto esistente.

Sintassi

Set-Contact -Identity <ContactIdParameter> [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-Initials <String>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-WebPage <String>]

Set-Contact [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-Initials <String>] [-Instance <Contact>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-WebPage <String>]

Descrizione dettagliata

È possibile utilizzare il cmdlet Set-Contact per modificare le impostazioni degli oggetti contatto visualizzabili in Utenti e computer di Active Directory. Se il contatto è abilitato all'utilizzo della posta, utilizzare il cmdlet ** Set-MailContact** per modificare le impostazioni di posta elettronica del contatto non disponibili quando si utilizza il cmdlet Set-Contact. Per ulteriori informazioni sul cmdlet Set-MailContact, vedere Set-MailContact (RTM).

Per eseguire il cmdlet Set-Contact, è necessario utilizzare un account che disponga della seguente delega:

Ruolo Exchange Recipient Administrator
Ruolo Account Operator per i contenitori applicabili di Active Directory

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
Identity	Obbligatorio	Microsoft.Exchange.Configuration.Tasks.ContactIdParameter	Il parametro Identity consente di specificare l'oggetto che si desidera modificare. Può assumere uno dei seguenti valori per l'oggetto contatto: GUID Nome distinto (Distinguished Name, DN) Nome canonico Nome Il parametro Identity non può essere utilizzato nel caso in cui sia specificato il parametro Instance.
AssistantName	Facoltativo	System.String	Il parametro AssistantName consente di definire il nome dell'assistente del contatto.
Città	Facoltativo	System.String	Il parametro City consente di definire la città del contatto.
Company	Facoltativo	System.String	Il parametro Company consente di definire la società del contatto.
CountryOrRegion	Facoltativo	Microsoft.Exchange.Data.Directory.CountryInfo	Il parametro CountryOrRegion consente di definire il Paese o l'area geografica del contatto.
CreateDTMFMap	Facoltativo	System.Boolean	Questo parametro consente di specificare una mappa DTMF (Dual Tone Multi-Frequency) da creare per il contatto.
Department	Facoltativo	System.String	Il parametro Department consente di definire il reparto del contatto.
DisplayName	Facoltativo	System.String	È possibile utilizzare il parametro DisplayName per specificare il nome del contatto in Exchange Management Console e nell'elenco indirizzi globale (GAL) di Exchange. DisplayName si applica solo agli oggetti abilitati alla posta.
DomainController	Facoltativo	Microsoft.Exchange.Data.Fqdn	Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di scrivere e modifiche alla configurazione nel servizio directory di Active Directory, includere il parametro DomainController.
Fax	Facoltativo	System.String	Il parametro Fax consente di definire il numero di fax del contatto.
FirstName	Facoltativo	System.String	Il parametro FirstName consente di definire il nome del contatto.
HomePhone	Facoltativo	System.String	Il parametro HomePhone consente di definire il numero di telefono dell'abitazione del contatto.
Iniziali	Facoltativo	System.String	Il parametro Initials consente di definire le iniziali del nome del contatto.
Instance	Facoltativo	Microsoft.Exchange.Data.Directory.Management.Contact	Il parametro Instance consente di trasmettere l'intero oggetto al comando da elaborare. Viene utilizzato principalmente negli script in cui è necessario trasmettere l'intero oggetto al comando. Il parametro Instance non può essere utilizzato nel caso in cui sia specificato il parametro Identity.
LastName	Facoltativo	System.String	Il parametro LastName consente di definire il cognome del contatto.
Manager	Facoltativo	Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter	Il parametro Manager consente di definire il manager del contatto.
MobilePhone	Facoltativo	System.String	Il parametro MobilePhone consente di definire il numero del cellulare principale del contatto.
Nome	Facoltativo	System.String	Il parametro Name consente di specificare il nome del contatto in Utenti e computer di Active Directory e, se il gruppo è abilitato alla posta, anche nel campo Nome gruppo in Exchange Management Console. Il valore Name non può contenere più di 64 caratteri.
Note	Facoltativo	System.String	Il parametro Notes consente di definire informazioni aggiuntive sul contatto.
Ufficio	Facoltativo	System.String	Il parametro Office consente di definire il nome o il numero dell'ufficio fisico del contatto.
OtherFax	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro OtherFax consente di definire il numero di fax alternativo del contatto.
OtherHomePhone	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro OtherHomePhone consente di definire il numero di telefono alternativo dell'abitazione del contatto.
OtherTelephone	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro OtherTelephone consente di definire il numero di telefono alternativo dell'ufficio del contatto.
Pager	Facoltativo	System.String	Il parametro Pager consente di definire il numero del cercapersone del contatto.
Phone	Facoltativo	System.String	Il parametro Phone consente di definire il numero di telefono dell'ufficio del contatto.
PhoneticDisplayName	Facoltativo	System.String	Il parametro PhoneticDisplayName specifica una pronuncia fonetica del parametro DisplayName. La lunghezza massima del valore di questo parametro è 255 caratteri. Per ulteriori informazioni sul parametro PhoneticDisplayName e sul riconoscimento vocale, vedere Concetti relativi alle ricerche nella directory di riconoscimento vocale automatico.
PostalCode	Facoltativo	System.String	Il parametro PostalCode consente di definire il codice di avviamento postale del contatto.
PostOfficeBox	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro PostOfficeBox consente di definire il numero di casetta postale del contatto.
SimpleDisplayName	Facoltativo	System.String	Il parametro SimpleDisplayName consente di visualizzare una descrizione alternativa dell'oggetto quando è consentito solo un set di caratteri limitato. Tale set di caratteri limitato è composto dai caratteri ASCII compresi tra il carattere 26 e il carattere 126. Il parametro SimpleDisplayName è rilevante solo per oggetti abilitati all'utilizzo della posta.
StateOrProvince	Facoltativo	System.String	Il parametro StateOrProvince consente di definire lo Stato o la provincia del contatto.
StreetAddress	Facoltativo	System.String	Il parametro StreetAddress consente di definire l'indirizzo fisico del contatto.
TelephoneAssistant	Facoltativo	System.String	Il parametro TelephoneAssistant consente di definire il numero di telefono dell'assistente del contatto.
Title	Facoltativo	System.String	Il parametro Title consente di definire la posizione professionale del contatto.
UMDialPlan	Facoltativo	Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter	Questo parametro consente di specificare l'ID della directory del dial plan.
UMDtmfMap	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Questo parametro consente di specificare se si intende creare una mappa DTMF definita dall'utente per il contatto abilitato alla messaggistica unificata.
WebPage	Facoltativo	System.String	Il parametro WebPage consente di definire la pagina Web del contatto.

Tipi di input

Tipi restituiti

Errori

Errore	Descrizione

Eccezioni

Eccezioni	Descrizione

Esempio

Nel seguente esempio di codice viene mostrato come utilizzare il comando Set-Contact per apportare le modifiche che seguono a un contatto esistente denominato Andrea Neri nel contenitore di utenti nel dominio di Active Directory denominato contoso.com:

Modifica del valore City in Roma.
Modifica del valore Company in Contoso.

Set-Contact -Identity "contoso.com/Users/Ted Bremer" -City "Seattle" -Company "Contoso"

Condividi tramite