Test-CsOnlineLisCivicAddress

Use the `Test-CsOnlineLisCivicAddress` cmdlet to verify that a civic address exists in the master street address guide (MSAG), and is suitable for emergency dispatch.

Syntax

Test-CsOnlineLisCivicAddress
    [-CivicAddressId <Object>]
    [-CompanyName <Object>]
    [-CountryOrRegion <Object>]
    [-BypassDualWrite <Object>]
    [-City <Object>]
    [-CompanyTaxId <Object>]
    [-Description <Object>]
    [-DomainController <Object>]
    [-Force]
    [-HouseNumber <Object>]
    [-HouseNumberSuffix <Object>]
    [-PostalCode <Object>]
    [-PostDirectional <Object>]
    [-PreDirectional <Object>]
    [-StateOrProvince <Object>]
    [-StreetName <Object>]
    [-StreetSuffix <Object>]
    [-Tenant <Object>]
    [-AsJob]
    [<CommonParameters>]

Description

The Test-CsOnlineLisCivicAddress cmdlet operates in two modes.

Validate and report: When called along with a list of address parameters, the cmdlet will test the address and report the result. Neither the address, nor the validation status is saved in the Location Information Service (LIS.) Use this mode to verify the address before creating it using the New-CsOnlineLisCivicAddress cmdlet.

Validate and save: When called with only the CivicAddressId parameter specified, the cmdlet will test the address and, if validated, save the validation status in the Location Information Service (LIS.)

The Test-CsOnlineLisCivicAddress produces three results:

Accepted as is: The address entered (validate and report mode), or specified (validate and save mode) is valid.

Accepted with changes: The address entered or specified would be valid with changes. The changes required are specified in the output.

Rejected: The address entered or specified cannot be found, and no suggested changes can be defined. The output will contain the reason the validation failed.

Examples

-------------------------- Example 1 --------------------------

Test-CsOnlineLisCivicAddress -CivicAddressId a363a9b8-1acd-41de-916a-296c7998a024

This example tests emergency dispatch suitability for the civic address with the specified identification.

-------------------------- Example 2 --------------------------

Test-CsOnlineLisCivicAddress -HouseNumber 3910 -StreetName Smith -StreetSuffix Street -PostDirectional NE -City Redmond -StateorProvince Washington -CountryOrRegion US -PostalCode 98052 -Description "Puget Sound" -CompanyName Contoso

This examples tests the emergency dispatch suitability for the civic address specified by address definition parameters.

Optional Parameters

-AsJob

{{Fill AsJob Description}}

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-BypassDualWrite

PARAMVALUE: $true | $false

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-City

Specifies the city of the civic address.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-CivicAddressId

Specifies the identification number of the civic address to test. If specified, no other address definition parameters are allowed. Civic address identities can be discovered by using the Get-CsOnlineLisCivicAddress cmdlet.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-CompanyName

Specifies the name of your organization.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-CompanyTaxId

PARAMVALUE: String

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-CountryOrRegion

Specifies the country or region of the civic address.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Description

Specifies an administrator defined description of the civic address.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-DomainController

This parameter is reserved for internal Microsoft use.

Type:Object
Aliases:DC
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Force

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.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-HouseNumber

Specifies the numeric portion of the civic address.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-HouseNumberSuffix

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

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-PostDirectional

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

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-PostalCode

Specifies the postal code of the civic address.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-PreDirectional

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

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-StateOrProvince

Specifies the state or province of the new civic address.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-StreetName

Specifies the street name of the civic address.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-StreetSuffix

Specifies a modifier of the street name of the civic address. The street suffix will typically be something like street, avenue, way, or boulevard.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Tenant

This parameter is reserved for internal Microsoft use.

Type:Object
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online

Inputs

The address accepts pipelined input from the Get-CsOnlineLisCivicAddress cmdlet.

Outputs

None