Share via


Update-MgBetaUserContact

Update the navigation property contacts in users

Note

To view the v1.0 release of this cmdlet, view Update-MgUserContact

Syntax

UpdateExpanded (Default)

Update-MgBetaUserContact
    -ContactId <String>
    -UserId <String>
    [-ResponseHeadersVariable <String>]
    [-AdditionalProperties <Hashtable>]
    [-AssistantName <String>]
    [-Birthday <DateTime>]
    [-Categories <String[]>]
    [-ChangeKey <String>]
    [-Children <String[]>]
    [-CompanyName <String>]
    [-CreatedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmailAddresses <IMicrosoftGraphTypedEmailAddress[]>]
    [-Extensions <IMicrosoftGraphExtension[]>]
    [-FileAs <String>]
    [-Flag <IMicrosoftGraphFollowupFlag>]
    [-Gender <String>]
    [-Generation <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-ImAddresses <String[]>]
    [-Initials <String>]
    [-IsFavorite]
    [-JobTitle <String>]
    [-LastModifiedDateTime <DateTime>]
    [-Manager <String>]
    [-MiddleName <String>]
    [-MultiValueExtendedProperties <IMicrosoftGraphMultiValueLegacyExtendedProperty[]>]
    [-NickName <String>]
    [-OfficeLocation <String>]
    [-ParentFolderId <String>]
    [-PersonalNotes <String>]
    [-Phones <IMicrosoftGraphPhone[]>]
    [-Photo <IMicrosoftGraphProfilePhoto>]
    [-PostalAddresses <IMicrosoftGraphPhysicalAddress[]>]
    [-Profession <String>]
    [-SingleValueExtendedProperties <IMicrosoftGraphSingleValueLegacyExtendedProperty[]>]
    [-SpouseName <String>]
    [-Surname <String>]
    [-Title <String>]
    [-Websites <IMicrosoftGraphWebsite[]>]
    [-WeddingAnniversary <DateTime>]
    [-YomiCompanyName <String>]
    [-YomiGivenName <String>]
    [-YomiSurname <String>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Update

Update-MgBetaUserContact
    -ContactId <String>
    -UserId <String>
    -BodyParameter <IMicrosoftGraphContact>
    [-ResponseHeadersVariable <String>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentityExpanded

Update-MgBetaUserContact
    -InputObject <IPersonalContactsIdentity>
    [-ResponseHeadersVariable <String>]
    [-AdditionalProperties <Hashtable>]
    [-AssistantName <String>]
    [-Birthday <DateTime>]
    [-Categories <String[]>]
    [-ChangeKey <String>]
    [-Children <String[]>]
    [-CompanyName <String>]
    [-CreatedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmailAddresses <IMicrosoftGraphTypedEmailAddress[]>]
    [-Extensions <IMicrosoftGraphExtension[]>]
    [-FileAs <String>]
    [-Flag <IMicrosoftGraphFollowupFlag>]
    [-Gender <String>]
    [-Generation <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-ImAddresses <String[]>]
    [-Initials <String>]
    [-IsFavorite]
    [-JobTitle <String>]
    [-LastModifiedDateTime <DateTime>]
    [-Manager <String>]
    [-MiddleName <String>]
    [-MultiValueExtendedProperties <IMicrosoftGraphMultiValueLegacyExtendedProperty[]>]
    [-NickName <String>]
    [-OfficeLocation <String>]
    [-ParentFolderId <String>]
    [-PersonalNotes <String>]
    [-Phones <IMicrosoftGraphPhone[]>]
    [-Photo <IMicrosoftGraphProfilePhoto>]
    [-PostalAddresses <IMicrosoftGraphPhysicalAddress[]>]
    [-Profession <String>]
    [-SingleValueExtendedProperties <IMicrosoftGraphSingleValueLegacyExtendedProperty[]>]
    [-SpouseName <String>]
    [-Surname <String>]
    [-Title <String>]
    [-Websites <IMicrosoftGraphWebsite[]>]
    [-WeddingAnniversary <DateTime>]
    [-YomiCompanyName <String>]
    [-YomiGivenName <String>]
    [-YomiSurname <String>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentity

Update-MgBetaUserContact
    -InputObject <IPersonalContactsIdentity>
    -BodyParameter <IMicrosoftGraphContact>
    [-ResponseHeadersVariable <String>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Update the navigation property contacts in users

Permissions

Permission type Permissions (from least to most privileged)
Delegated (work or school account) Contacts.ReadWrite,
Delegated (personal Microsoft account) Contacts.ReadWrite,
Application Contacts.ReadWrite,

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.Beta.PersonalContacts

$params = @{
	emailAddresses = @(
		@{
			type = "personal"
			name = "Pavel Bansky"
			address = "pavelb@adatum.onmicrosoft.com"
		}
		@{
			address = "pavelb@fabrikam.onmicrosoft.com"
			name = "Pavel Bansky"
			type = "other"
			otherLabel = "Volunteer work"
		}
	)
}

# A UPN can also be used as -UserId.
Update-MgBetaUserContact -UserId $userId -ContactId $contactId -BodyParameter $params

This example shows how to use the Update-MgBetaUserContact Cmdlet.

To learn about permissions for this resource, see the permissions reference.

Parameters

-AdditionalProperties

Additional Parameters

Parameter properties

Type:Hashtable
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AssistantName

The name of the contact's assistant.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Birthday

The contact's birthday. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z

Parameter properties

Type:DateTime
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-BodyParameter

contact To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

Parameter properties

Type:IMicrosoftGraphContact
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Update
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentity
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Categories

The categories associated with the item.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ChangeKey

Identifies the version of the item. Every time the item is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Children

The names of the contact's children.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CompanyName

The name of the contact's company.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ContactId

The unique identifier of contact

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Update
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CreatedDateTime

The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z

Parameter properties

Type:DateTime
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Department

The contact's department.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisplayName

The contact's display name. You can specify the display name in a create or update operation. Later updates to other properties might cause an automatically generated value to overwrite the displayName value you specified. To preserve a pre-existing value, always include it as displayName in an update operation.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EmailAddresses

The contact's email addresses. To construct, see NOTES section for EMAILADDRESSES properties and create a hash table.

Parameter properties

Type:

IMicrosoftGraphTypedEmailAddress[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Extensions

The collection of open extensions defined for the contact. Nullable. To construct, see NOTES section for EXTENSIONS properties and create a hash table.

Parameter properties

Type:

IMicrosoftGraphExtension[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-FileAs

The name the contact is filed under.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Flag

followupFlag To construct, see NOTES section for FLAG properties and create a hash table.

Parameter properties

Type:IMicrosoftGraphFollowupFlag
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Gender

The contact's gender.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Generation

The contact's suffix.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-GivenName

The contact's given name.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Headers

Optional headers that will be added to the request.

Parameter properties

Type:IDictionary
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Id

The unique identifier for an entity. Read-only.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ImAddresses

The contact's instant messaging (IM) addresses.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Initials

The contact's initials.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

Parameter properties

Type:IPersonalContactsIdentity
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateViaIdentityExpanded
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentity
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-IsFavorite

Update the navigation property contacts in users

Permissions

Permission type Permissions (from least to most privileged)
Delegated (work or school account) Contacts.ReadWrite,
Delegated (personal Microsoft account) Contacts.ReadWrite,
Application Contacts.ReadWrite,

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-JobTitle

The contact's job title.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-LastModifiedDateTime

The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z

Parameter properties

Type:DateTime
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Manager

The name of the contact's manager.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MiddleName

The contact's middle name.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MultiValueExtendedProperties

The collection of multi-value extended properties defined for the contact. Read-only. Nullable. To construct, see NOTES section for MULTIVALUEEXTENDEDPROPERTIES properties and create a hash table.

Parameter properties

Type:

IMicrosoftGraphMultiValueLegacyExtendedProperty[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NickName

The contact's nickname.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-OfficeLocation

The location of the contact's office.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ParentFolderId

The ID of the contact's parent folder.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PersonalNotes

The user's notes about the contact.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Phones

Phone numbers associated with the contact, for example, home phone, mobile phone, and business phone. To construct, see NOTES section for PHONES properties and create a hash table.

Parameter properties

Type:

IMicrosoftGraphPhone[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Photo

profilePhoto To construct, see NOTES section for PHOTO properties and create a hash table.

Parameter properties

Type:IMicrosoftGraphProfilePhoto
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PostalAddresses

Addresses associated with the contact, for example, home address and business address. To construct, see NOTES section for POSTALADDRESSES properties and create a hash table.

Parameter properties

Type:

IMicrosoftGraphPhysicalAddress[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Profession

The contact's profession.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ResponseHeadersVariable

Optional Response Headers Variable.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:RHV

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SingleValueExtendedProperties

The collection of single-value extended properties defined for the contact. Read-only. Nullable. To construct, see NOTES section for SINGLEVALUEEXTENDEDPROPERTIES properties and create a hash table.

Parameter properties

Type:

IMicrosoftGraphSingleValueLegacyExtendedProperty[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SpouseName

The name of the contact's spouse/partner.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Surname

The contact's surname.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Title

The contact's title.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-UserId

The unique identifier of user

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Update
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Websites

Web sites associated with the contact. To construct, see NOTES section for WEBSITES properties and create a hash table.

Parameter properties

Type:

IMicrosoftGraphWebsite[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WeddingAnniversary

The contact's wedding anniversary.

Parameter properties

Type:DateTime
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-YomiCompanyName

The phonetic Japanese company name of the contact.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-YomiGivenName

The phonetic Japanese given name (first name) of the contact.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-YomiSurname

The phonetic Japanese surname (last name) of the contact.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UpdateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
UpdateViaIdentityExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphContact

Microsoft.Graph.Beta.PowerShell.Models.IPersonalContactsIdentity

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphContact

Notes

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

BODYPARAMETER <IMicrosoftGraphContact>: contact

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Categories <String- []>]: The categories associated with the item.
  • [ChangeKey <String>]: Identifies the version of the item. Every time the item is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.
  • [CreatedDateTime <DateTime?>]: The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
  • [LastModifiedDateTime <DateTime?>]: The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [AssistantName <String>]: The name of the contact's assistant.
  • [Birthday <DateTime?>]: The contact's birthday. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
  • [Children <String- []>]: The names of the contact's children.
  • [CompanyName <String>]: The name of the contact's company.
  • [Department <String>]: The contact's department.
  • [DisplayName <String>]: The contact's display name. You can specify the display name in a create or update operation. Later updates to other properties might cause an automatically generated value to overwrite the displayName value you specified. To preserve a pre-existing value, always include it as displayName in an update operation.
  • [EmailAddresses <IMicrosoftGraphTypedEmailAddress- []>]: The contact's email addresses.
    • [Address <String>]: The email address of an entity instance.
    • [Name <String>]: The display name of an entity instance.
    • [OtherLabel <String>]: To specify a custom type of email address, set type to other, and assign otherLabel to a custom string. For example, you may use a specific email address for your volunteer activities. Set type to other, and set otherLabel to a custom string such as Volunteer work.
    • [Type <String>]: emailType
  • [Extensions <IMicrosoftGraphExtension- []>]: The collection of open extensions defined for the contact. Nullable.
    • [Id <String>]: The unique identifier for an entity. Read-only.
  • [FileAs <String>]: The name the contact is filed under.
  • [Flag <IMicrosoftGraphFollowupFlag>]: followupFlag
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [CompletedDateTime <IMicrosoftGraphDateTimeZone>]: dateTimeTimeZone
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [DateTime <String>]: A single point of time in a combined date and time representation ({date}T{time}). For example, '2019-04-16T09:00:00'.
      • [TimeZone <String>]: Represents a time zone, for example, 'Pacific Standard Time'. See below for possible values.
    • [DueDateTime <IMicrosoftGraphDateTimeZone>]: dateTimeTimeZone
    • [FlagStatus <String>]: followupFlagStatus
    • [StartDateTime <IMicrosoftGraphDateTimeZone>]: dateTimeTimeZone
  • [Gender <String>]: The contact's gender.
  • [Generation <String>]: The contact's suffix.
  • [GivenName <String>]: The contact's given name.
  • [ImAddresses <String- []>]: The contact's instant messaging (IM) addresses.
  • [Initials <String>]: The contact's initials.
  • [IsFavorite <Boolean?>]:
  • [JobTitle <String>]: The contact's job title.
  • [Manager <String>]: The name of the contact's manager.
  • [MiddleName <String>]: The contact's middle name.
  • [MultiValueExtendedProperties <IMicrosoftGraphMultiValueLegacyExtendedProperty- []>]: The collection of multi-value extended properties defined for the contact. Read-only. Nullable.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [Value <String- []>]: A collection of property values.
  • [NickName <String>]: The contact's nickname.
  • [OfficeLocation <String>]: The location of the contact's office.
  • [ParentFolderId <String>]: The ID of the contact's parent folder.
  • [PersonalNotes <String>]: The user's notes about the contact.
  • [Phones <IMicrosoftGraphPhone- []>]: Phone numbers associated with the contact, for example, home phone, mobile phone, and business phone.
    • [Number <String>]: The phone number.
    • [Type <String>]: phoneType
  • [Photo <IMicrosoftGraphProfilePhoto>]: profilePhoto
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [Height <Int32?>]: The height of the photo. Read-only.
    • [Width <Int32?>]: The width of the photo. Read-only.
  • [PostalAddresses <IMicrosoftGraphPhysicalAddress- []>]: Addresses associated with the contact, for example, home address and business address.
    • [City <String>]: The city.
    • [CountryOrRegion <String>]: The country or region. It's a free-format string value, for example, 'United States'.
    • [PostOfficeBox <String>]: The post office box number.
    • [PostalCode <String>]: The postal code.
    • [State <String>]: The state.
    • [Street <String>]: The street.
    • [Type <String>]: physicalAddressType
  • [Profession <String>]: The contact's profession.
  • [SingleValueExtendedProperties <IMicrosoftGraphSingleValueLegacyExtendedProperty- []>]: The collection of single-value extended properties defined for the contact. Read-only. Nullable.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [Value <String>]: A property value.
  • [SpouseName <String>]: The name of the contact's spouse/partner.
  • [Surname <String>]: The contact's surname.
  • [Title <String>]: The contact's title.
  • [Websites <IMicrosoftGraphWebsite- []>]: Web sites associated with the contact.
    • [Address <String>]: The URL of the website.
    • [DisplayName <String>]: The display name of the web site.
    • [Type <String>]: websiteType
  • [WeddingAnniversary <DateTime?>]: The contact's wedding anniversary.
  • [YomiCompanyName <String>]: The phonetic Japanese company name of the contact.
  • [YomiGivenName <String>]: The phonetic Japanese given name (first name) of the contact.
  • [YomiSurname <String>]: The phonetic Japanese surname (last name) of the contact.

EMAILADDRESSES <IMicrosoftGraphTypedEmailAddress- []>: The contact's email addresses.

  • [Address <String>]: The email address of an entity instance.
  • [Name <String>]: The display name of an entity instance.
  • [OtherLabel <String>]: To specify a custom type of email address, set type to other, and assign otherLabel to a custom string. For example, you may use a specific email address for your volunteer activities. Set type to other, and set otherLabel to a custom string such as Volunteer work.
  • [Type <String>]: emailType

EXTENSIONS <IMicrosoftGraphExtension- []>: The collection of open extensions defined for the contact. Nullable.

  • [Id <String>]: The unique identifier for an entity. Read-only.

FLAG <IMicrosoftGraphFollowupFlag>: followupFlag

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [CompletedDateTime <IMicrosoftGraphDateTimeZone>]: dateTimeTimeZone
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [DateTime <String>]: A single point of time in a combined date and time representation ({date}T{time}). For example, '2019-04-16T09:00:00'.
    • [TimeZone <String>]: Represents a time zone, for example, 'Pacific Standard Time'. See below for possible values.
  • [DueDateTime <IMicrosoftGraphDateTimeZone>]: dateTimeTimeZone
  • [FlagStatus <String>]: followupFlagStatus
  • [StartDateTime <IMicrosoftGraphDateTimeZone>]: dateTimeTimeZone

INPUTOBJECT <IPersonalContactsIdentity>: Identity Parameter

  • [ContactFolderId <String>]: The unique identifier of contactFolder
  • [ContactFolderId1 <String>]: The unique identifier of contactFolder
  • [ContactId <String>]: The unique identifier of contact
  • [ExtensionId <String>]: The unique identifier of extension
  • [UserId <String>]: The unique identifier of user

MULTIVALUEEXTENDEDPROPERTIES <IMicrosoftGraphMultiValueLegacyExtendedProperty- []>: The collection of multi-value extended properties defined for the contact. Read-only. Nullable.

  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [Value <String- []>]: A collection of property values.

PHONES <IMicrosoftGraphPhone- []>: Phone numbers associated with the contact, for example, home phone, mobile phone, and business phone.

  • [Number <String>]: The phone number.
  • [Type <String>]: phoneType

PHOTO <IMicrosoftGraphProfilePhoto>: profilePhoto

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [Height <Int32?>]: The height of the photo. Read-only.
  • [Width <Int32?>]: The width of the photo. Read-only.

POSTALADDRESSES <IMicrosoftGraphPhysicalAddress- []>: Addresses associated with the contact, for example, home address and business address.

  • [City <String>]: The city.
  • [CountryOrRegion <String>]: The country or region. It's a free-format string value, for example, 'United States'.
  • [PostOfficeBox <String>]: The post office box number.
  • [PostalCode <String>]: The postal code.
  • [State <String>]: The state.
  • [Street <String>]: The street.
  • [Type <String>]: physicalAddressType

SINGLEVALUEEXTENDEDPROPERTIES <IMicrosoftGraphSingleValueLegacyExtendedProperty- []>: The collection of single-value extended properties defined for the contact. Read-only. Nullable.

  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [Value <String>]: A property value.

WEBSITES <IMicrosoftGraphWebsite- []>: Web sites associated with the contact.

  • [Address <String>]: The URL of the website.
  • [DisplayName <String>]: The display name of the web site.
  • [Type <String>]: websiteType