From eca89520e505a7ff0002b17f04448f0214985e54 Mon Sep 17 00:00:00 2001 From: jechen2 Date: Tue, 10 Dec 2024 09:29:14 -0800 Subject: [PATCH 1/5] Update Set-CsOnlineLisCivicAddress.md Updated to include which fields are publicly editable and for which limited countries --- .../teams/Set-CsOnlineLisCivicAddress.md | 42 +++++++++++++------ 1 file changed, 30 insertions(+), 12 deletions(-) diff --git a/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md b/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md index c2c9e30abb..6a0be6d37f 100644 --- a/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md +++ b/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md @@ -16,7 +16,7 @@ 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 @@ -33,6 +33,11 @@ Set-CsOnlineLisCivicAddress -CivicAddressId [-CompanyName ] [-Com ## DESCRIPTION Use the `Set-CsOnlineLisCivicAddress` cmdlet to modify an existing civic address which has not been validated. Validated civic addresses cannot be modified. +Address editing is restricted to the following countries/regions: +AU, BR, CA, HR, CZ, EE, HK, HU, IL, JP, LV, LT, MX, NZ, PL, PR, RO, SG, KR, SI, ZA, US + +If the user runs the PATCH request 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. + ## EXAMPLES ### Example 1 @@ -68,7 +73,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 +89,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 +106,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 +122,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 +156,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 +174,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 +208,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 +227,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 +243,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 +262,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 +281,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 +297,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 +313,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 +332,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 +413,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 +429,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 From 25cc635289424b812436864c3d5db74cccc8cf43 Mon Sep 17 00:00:00 2001 From: jechen2 Date: Tue, 17 Dec 2024 10:16:25 -0800 Subject: [PATCH 2/5] Update Set-CsOnlineLisCivicAddress.md addressed comments --- teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md b/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md index 6a0be6d37f..7f76bc5761 100644 --- a/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md +++ b/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md @@ -31,12 +31,13 @@ Set-CsOnlineLisCivicAddress -CivicAddressId [-CompanyName ] [-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. -Address editing is restricted to the following countries/regions: -AU, BR, CA, HR, CZ, EE, HK, HU, IL, JP, LV, LT, MX, NZ, PL, PR, RO, SG, KR, SI, ZA, US +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 the PATCH request 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. + +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 From e098d5bc7002fb1ad89a1beaf5191bb199108089 Mon Sep 17 00:00:00 2001 From: jechen2 Date: Tue, 17 Dec 2024 10:18:03 -0800 Subject: [PATCH 3/5] Update Set-CsOnlineLisCivicAddress.md --- teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md | 1 - 1 file changed, 1 deletion(-) diff --git a/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md b/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md index 7f76bc5761..e6a974688e 100644 --- a/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md +++ b/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md @@ -36,7 +36,6 @@ Use the `Set-CsOnlineLisCivicAddress` cmdlet to modify limited fields of an exis 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 From f8eee039c906b60c355f95d7d2fa867ce834e086 Mon Sep 17 00:00:00 2001 From: Ruchika Mittal Date: Wed, 18 Dec 2024 23:09:26 +0530 Subject: [PATCH 4/5] Update note format and add punctuation --- teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md b/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md index e6a974688e..cd9462a63e 100644 --- a/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md +++ b/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 public use with limited countries and certain fields. The remaining countries and fields are for Microsoft internal use only. +> [!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 @@ -34,7 +35,7 @@ Set-CsOnlineLisCivicAddress -CivicAddressId [-CompanyName ] [-Com 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 +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. From 56d34487b99456029580ff9dda15e23cefa076b1 Mon Sep 17 00:00:00 2001 From: Ruchika Mittal Date: Wed, 18 Dec 2024 23:17:03 +0530 Subject: [PATCH 5/5] pencil edit --- teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md b/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md index cd9462a63e..c2e7ee0591 100644 --- a/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md +++ b/teams/teams-ps/teams/Set-CsOnlineLisCivicAddress.md @@ -43,14 +43,14 @@ If the user runs this cmdlet on one of the unsupported countries, it may interfe ### 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.