Merge pull request MicrosoftDocs#12414 from jechen2/patch-3

Update Set-CsOnlineLisCivicAddress.md

Author: Ruchika-mittal01

teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md

@@ -16,7 +16,8 @@ ms.reviewer:
 Use the \`Set-CsOnlineLisCivicAddress\` cmdlet to modify an existing civic address which has not been validated.
 Validated civic addresses cannot be modified.
 
-**Note:** This cmdlet is only available for Microsoft internal use.
+> [!Note]
+> This cmdlet is only available for public use with limited countries and certain fields. The remaining countries and fields are for Microsoft internal use only.
 
 ## SYNTAX
 
@@ -31,20 +32,25 @@ Set-CsOnlineLisCivicAddress -CivicAddressId <Guid> [-CompanyName <String>] [-Com
 ```
 
 ## DESCRIPTION
-Use the `Set-CsOnlineLisCivicAddress` cmdlet to modify an existing civic address which has not been validated. Validated civic addresses cannot be modified.
+Use the `Set-CsOnlineLisCivicAddress` cmdlet to modify limited fields of an existing civic address.
+
+Editing address using this cmdlet is restricted to the following countries/regions:
+Australia, Brazil, Canada, Croatia, Czech Republic, Estonia, Hong Kong, Hungary, Israel, Japan, Latvia, Lithuania, Mexico, New Zealand, Poland, Puerto Rico, Romania, Singapore, South Korea, Slovenia, South Africa, United States.
+
+If the user runs this cmdlet on one of the unsupported countries, it may interfere with number assignment and potentially is against regulatory requirements, so public use of the API is limited to the above countries/regions.
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-Set-CsOnlineLisCivicAddress -CivicAddressid a363a9b8-1acd-41de-916a-296c7998a024 -Description "City Center" -CompanyName Contoso
+Set-CsOnlineLisCivicAddress -CivicAddressId a363a9b8-1acd-41de-916a-296c7998a024 -Description "City Center" -CompanyName Contoso
 ```
 
 This example modifies the description and company name of the civic address with the identity a363a9b8-1acd-41de-916a-296c7998a024.
 
 ### Example 2
 ```powershell
-Set-CsOnlineLisCivicAddress -CivicAddressid a363a9b8-1acd-41de-916a-296c7998a024 -Latitude 47.63952 -Longitude -122.12781 -ELIN MICROSOFT_ELIN
+Set-CsOnlineLisCivicAddress -CivicAddressId a363a9b8-1acd-41de-916a-296c7998a024 -Latitude 47.63952 -Longitude -122.12781 -ELIN MICROSOFT_ELIN
 ```
 
 This example modifies the latitude, longitude and ELIN name of the civic address with the identity a363a9b8-1acd-41de-916a-296c7998a024.
@@ -68,7 +74,7 @@ Accept wildcard characters: False
 ```
 
 ### -City
-Specifies a new city for the civic address.
+Specifies a new city for the civic address. Publicly editable.
 
 ```yaml
 Type: String
@@ -84,7 +90,8 @@ Accept wildcard characters: False
 ```
 
 ### -CityAlias
-Short form of the city name.
+Short form of the city name. 
+This parameter is reserved for internal Microsoft use.
 
 ```yaml
 Type: String
@@ -100,7 +107,7 @@ Accept wildcard characters: False
 ```
 
 ### -CompanyName
-Specifies a new company name for the civic address.
+Specifies a new company name for the civic address. Publicly editable.
 
 ```yaml
 Type: String
@@ -116,7 +123,8 @@ Accept wildcard characters: False
 ```
 
 ### -CompanyTaxId
-Used to store TaxId for regulatory reasons.
+Used to store TaxId for regulatory reasons. 
+This parameter is reserved for internal Microsoft use.
 
 ```yaml
 Type: String
@@ -149,6 +157,9 @@ Accept wildcard characters: False
 
 ### -CountryOrRegion
 Specifies a new country or region for the civic address.
+For public use, restricted to the following countries: 
+
+**AU, BR, CA, HR, CZ, EE, HK, HU, IL, JP, LV, LT, MX, NZ, PL, PR, RO, SG, KR, SI, ZA, US**
 
 ```yaml
 Type: String
@@ -164,7 +175,7 @@ Accept wildcard characters: False
 ```
 
 ### -Description
-Specifies a new description for the civic address.
+Specifies a new description for the civic address. Publicly editable.
 
 ```yaml
 Type: String
@@ -198,7 +209,7 @@ Accept wildcard characters: False
 ```
 
 ### -HouseNumber
-Specifies the new numeric portion of the civic address.
+Specifies the new numeric portion of the civic address. Publicly editable.
 
 ```yaml
 Type: String
@@ -217,6 +228,8 @@ Accept wildcard characters: False
 Specifies the new 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".
 
+This parameter is reserved for internal Microsoft use.
+
 ```yaml
 Type: String
 Parameter Sets: (All)
@@ -231,7 +244,7 @@ Accept wildcard characters: False
 ```
 
 ### -PostalCode
-Specifies the new postal code of the civic address.
+Specifies the new postal code of the civic address. Publicly editable.
 
 ```yaml
 Type: String
@@ -250,6 +263,8 @@ Accept wildcard characters: False
 Specifies the new directional attribute of the civic address which follows the street name.
 For example, "425 Smith Avenue NE".
 
+This parameter is reserved for internal Microsoft use.
+
 ```yaml
 Type: String
 Parameter Sets: (All)
@@ -267,6 +282,8 @@ Accept wildcard characters: False
 Specifies the new directional attribute of the civic address which precedes the street name.
 For example, "425 NE Smith Avenue ".
 
+This parameter is reserved for internal Microsoft use.
+
 ```yaml
 Type: String
 Parameter Sets: (All)
@@ -281,7 +298,7 @@ Accept wildcard characters: False
 ```
 
 ### -StateOrProvince
-Specifies the new state or province of the civic address.
+Specifies the new state or province of the civic address. Publicly editable.
 
 ```yaml
 Type: String
@@ -297,7 +314,7 @@ Accept wildcard characters: False
 ```
 
 ### -StreetName
-Specifies the new street name of the civic address.
+Specifies the new street name of the civic address. Publicly editable.
 
 ```yaml
 Type: String
@@ -316,6 +333,8 @@ Accept wildcard characters: False
 Specifies the new modifier of the street name of the new civic address.
 The street suffix will typically be something like street, avenue, way, or boulevard.
 
+This parameter is reserved for internal Microsoft use.
+
 ```yaml
 Type: String
 Parameter Sets: (All)
@@ -395,7 +414,7 @@ Accept wildcard characters: False
 ```
 
 ### -Latitude
-Specifies the angular distance of a place north or south of the earth's equator in the decimal degrees format.
+Specifies the angular distance of a place north or south of the earth's equator in the decimal degrees format. Publicly editable.
 
 ```yaml
 Type: String
@@ -411,7 +430,7 @@ Accept wildcard characters: False
 ```
 
 ### -Longitude
-Specifies the angular distance of a place east or west of the meridian at Greenwich, England, in the decimal degrees format.
+Specifies the angular distance of a place east or west of the meridian at Greenwich, England, in the decimal degrees format. Publicly editable.
 
 ```yaml
 Type: String