Set-Contact

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2009-05-12

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

Sintassi

Set-Contact -Identity <ContactIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-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>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Contact [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-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>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

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 eseguire il cmdlet Set-Contact, è necessario utilizzare un account che disponga della seguente delega:

• Ruolo Exchange Recipient Administrator

• Ruolo operatore account per i contenitori Active Directory applicabili

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 da modificare. Può assumere uno dei seguenti valori per l'oggetto contatto: GUID Nome distinto (DN) Nome canonico Nome Il parametro Identity non può essere utilizzato nel caso in cui sia specificato il parametro Instance.
AllowUMCallsFromNonUsers	Facoltativo	Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags	Questo parametro consente di specificare se escludere il contatto dalle ricerche di directory.
AssistantName	Facoltativo	System.String	Il parametro AssistantName consente di definire il nome dell'assistente del contatto.
City	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.
Confirm	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro Confirm determina l'interruzione dell'elaborazione e richiede che l'utente, prima che l'elaborazione continui, confermi l'operazione che verrà eseguita dal comando. Non è necessario specificare alcun valore con il parametro Confirm.
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 le 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.
IgnoreDefaultScope	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro IgnoreDefaultScope indica al comando di ignorare l'impostazione predefinita dell'ambito del destinatario per Exchange Management Shell e utilizzare l'intera foresta come ambito. In questo modo il comando può accedere agli oggetti Active Directory che non si trovano correntemente nell'ambito predefinito. L'utilizzo del parametro IgnoreDefaultScope comporta le seguenti restrizioni: Non è possibile utilizzare il parametro DomainController. Il comando utilizzerà automaticamente il server di catalogo globale corretto. È possibile utilizzare solo il nome distinto per il parametro Identity. Altre forme di identificazione, quali l'alias o il GUID, non sono accettate.
Initials	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 passare al comando l'intero oggetto per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare al comando un oggetto completo. 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.
Name	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.
Notes	Facoltativo	System.String	Il parametro Notes consente di definire informazioni aggiuntive sul contatto.
Office	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 consente di specificare la pronuncia fonetica del parametro DisplayName. Il valore di questo parametro può contenere al massimo 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 viene utilizzato per visualizzare una descrizione alternativa dell'oggetto quando è consentito solo un set di caratteri limitato, Tale set di caratteri limitato si compone dei seguenti caratteri: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:? SimpleDisplayName si applica solo agli oggetti abilitati alla 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 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.
UseRusServer	Facoltativo	System.String	Nota: Questo parametro è disponibile solo in Exchange 2007 SP2. Il parametro UseRusServer consente al comando di utilizzare il server Cassette postali specificato su cui è in esecuzione il Servizio elenco di indirizzi per ottenere e impostare la cassetta postale e gli attributi dell'utente di Active Directory. Il Servizio elenco indirizzi è un componente del servizio Supervisore sistema di Exchange. Il Servizio elenco indirizzi consente di creare e gestire i valori degli attributi specifici di Exchange in Active Directory. È possibile utilizzare il Servizio elenco indirizzi per aggiornare gli oggetti destinatario in un dominio utilizzando informazioni specifiche, come l'appartenenza a un elenco di indirizzi e gli indirizzi di posta elettronica.
WebPage	Facoltativo	System.String	Il parametro WebPage consente di definire la pagina Web del contatto.
WhatIf	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, è possibile visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Non è necessario specificare alcun valore con il parametro WhatIf.
WindowsEmailAddress	Facoltativo	Microsoft.Exchange.Data.SmtpAddress	Il parametro WindowsEmailAddressconsente di specificare l'indirizzo di posta elettronica del contatto archiviato in Active Directory.

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"