New-CsOnlineLisCivicAddress

 

Topic Last Modified: 2016-04-15

Use the New-CsOnlineLisCivicAddress cmdlet to create a civic address in the Location Information Service (LIS.)

New-CsOnlineLisCivicAddress -CompanyName <String> -CountryOrRegion <String> [-City <String>] [-CityAlias <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-StateOrProvince <String>] [-StreetName <String>] [-StreetSuffix <String>] [-Tenant <Guid>] [-WhatIf [<SwitchParameter>]]

This example creates a new civic address described as "West Coast Headquarters": 3910 Smith Street NE, Redmond WA, 98052.

New -CsOnlineLisCivicAddress -HouseNumber 3910 -StreetName Smith -StreetSuffix Street -PostDirectional NE -City Redmond -StateorProvince Washington -Country US -PostalCode 98052 -Description "West Coast Headquarters" -CompanyName Contoso

Because each civic address needs at least one location to assign to users, creating a new civic address also creates a default location. This is useful in cases where a civic address has no particular sub-locations. In that scenario you can create the civic address using the New –CsOnlineLisCivicAddress cmdlet and use the default location identifier for assignment to users. The example output from the Get-CsOnlineLisCivicAddress below shows the DefaultLocationId property.

CivicAddressId     : 51a8a6e3-dae4-4653-9a99-a6e71c4c24ac
HouseNumber        :
HouseNumberSuffix  :
PreDirectional     :
StreetName         :
StreetSuffix       :
PostDirectional    :
City               :
PostalCode         :
StateOrProvince    :
CountryOrRegion    : US
Description        :
CompanyName        : MSFT
DefaultLocationId  : 75301b5d-3609-458e-a379-da9a1ab33228
ValidationStatus   : NotValidated
NumberOfVoiceUsers : 0

 

Parameter Required Type Description

CompanyName

Required

System.String

Specifies the name of your organization.

CountryOrRegion

Required

System.String

Specifies the country or region of the new civic address. Needs to be a valid country code as contained in the ISO 3166-1 alpha-2 specification.

City

Optional

System.String

Specifies the city of the new civic address.

CityAlias

Optional

System.String

PARAMVALUE: String

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm switch causes the command to pause processing, and requires confirmation to proceed.

Description

Optional

System.String

Specifies an administrator defined description of the new civic address.

DomainController

Optional

Microsoft.Rtc.Management.Deploy.Fqdn

This parameter is reserved for internal Microsoft use.

Force

Optional

System.Management.Automation.SwitchParameter

The Force switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the Force switch isn't provided in the command, you're prompted for administrative input if required.

HouseNumber

Optional

System.String

Specifies the numeric portion of the new civic address.

HouseNumberSuffix

Optional

System.String

Specifies the numeric suffix of the new civic address. For example, if the property was multiplexed, the HouseNumberSuffix parameter would be the multiplex specifier: "425A Smith Avenue", or "425B Smith Avenue".

PostalCode

Optional

System.String

Specifies the postal code of the new civic address.

PostDirectional

Optional

System.String

Specifies the directional attribute of the new civic address which follows the street name. For example, "425 Smith Avenue NE".

PreDirectional

Optional

System.String

Specifies the directional attribute of the new civic address which precedes the street name. For example, "425 NE Smith Avenue ".

StateOrProvince

Optional

System.String

Specifies the state or province of the new civic address.

StreetName

Optional

System.String

Specifies the street name of the new civic address.

StreetSuffix

Optional

System.String

Specifies the street type of the new civic address. The street suffix will typically be something like street, avenue, way, or boulevard.

Tenant

Optional

System.Guid

This parameter is reserved for internal Microsoft use.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf switch causes the command to simulate its results. By using this switch, you can view what changes would occur without having to commit those changes.

 
Show: