From c3c82ba04152b76a07a02f1d54928dddf36a3346 Mon Sep 17 00:00:00 2001
From: "Mike F. Robbins" <mike.robbins@microsoft.com>
Date: Wed, 15 Apr 2020 09:34:02 -0500
Subject: [PATCH 1/2] Fixes #11298 - Example works with multiple subnets

---
 src/Network/Network/help/New-AzPrivateEndpoint.md | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/src/Network/Network/help/New-AzPrivateEndpoint.md b/src/Network/Network/help/New-AzPrivateEndpoint.md
index 08c1f1970ed0..c8d4751682f2 100644
--- a/src/Network/Network/help/New-AzPrivateEndpoint.md
+++ b/src/Network/Network/help/New-AzPrivateEndpoint.md
@@ -24,14 +24,18 @@ The **New-AzPrivateEndpoint** cmdlet creates a private endpoint.
 ## EXAMPLES
 
 ### 1: Create a private endpoint
-```
+
+The following example creates a private endpoint with a specific private link service ID in the
+specified subnet in a virtual network.
+
+```powershell
 $virtualNetwork = Get-AzVirtualNetwork -ResourceName MyVirtualNetwork -ResourceGroupName TestResourceGroup
-$plsConnection= New-AzPrivateLinkServiceConnection -Name MyPLSConnections -PrivateLinkServiceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/TestResourceGroup/providers/Microsoft.Network/privateLinkServices/privateLinkService" -RequestMessage "Please Approve my request"
-New-AzPrivateEndpoint -Name MyPrivateEndpoint -ResourceGroup TestResourceGroup -Location centralus -PrivateLinkServiceConnection $plsConnection -Subnet $virtualNetwork.Subnets[0]
+# View the results of $virtualNetwork and change 'mysubnet' in the following line to the appropriate subnet name.
+$subnet = $virtualNetwork | Select-Object -ExpandProperty subnets | Where-Object Name -eq 'mysubnet'
+$plsConnection= New-AzPrivateLinkServiceConnection -Name MyPLSConnections -PrivateLinkServiceId '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/TestResourceGroup/providers/Microsoft.Network/privateLinkServices/privateLinkService' -RequestMessage 'Please Approve my request'
+New-AzPrivateEndpoint -Name MyPrivateEndpoint -ResourceGroup TestResourceGroup -Location centralus -PrivateLinkServiceConnection $plsConnection -Subnet $subnet
 ```
 
-This example creates a private endpoint with specific private link service id in a specific subnet in a virtual network.
-
 ## PARAMETERS
 
 ### -AsJob

From 21753490405b61a14c1dcc0517e233b1821d1efb Mon Sep 17 00:00:00 2001
From: "Mike F. Robbins" <mike.robbins@microsoft.com>
Date: Wed, 15 Apr 2020 14:12:50 -0500
Subject: [PATCH 2/2] Standardized values in code examples

---
 .../Network/help/New-AzPrivateEndpoint.md     | 51 +++++++++++++------
 1 file changed, 35 insertions(+), 16 deletions(-)

diff --git a/src/Network/Network/help/New-AzPrivateEndpoint.md b/src/Network/Network/help/New-AzPrivateEndpoint.md
index c8d4751682f2..cc72ce9dc300 100644
--- a/src/Network/Network/help/New-AzPrivateEndpoint.md
+++ b/src/Network/Network/help/New-AzPrivateEndpoint.md
@@ -12,6 +12,8 @@ Creates a private endpoint.
 
 ## SYNTAX
 
+### All
+
 ```
 New-AzPrivateEndpoint -Name <String> -ResourceGroupName <String> -Location <String> -Subnet <PSSubnet>
  -PrivateLinkServiceConnection <PSPrivateLinkServiceConnection[]> [-ByManualRequest] [-Tag <Hashtable>]
@@ -19,27 +21,28 @@ New-AzPrivateEndpoint -Name <String> -ResourceGroupName <String> -Location <Stri
 ```
 
 ## DESCRIPTION
+
 The **New-AzPrivateEndpoint** cmdlet creates a private endpoint.
 
 ## EXAMPLES
 
-### 1: Create a private endpoint
+### Example 1: Create a private endpoint
 
 The following example creates a private endpoint with a specific private link service ID in the
 specified subnet in a virtual network.
 
 ```powershell
-$virtualNetwork = Get-AzVirtualNetwork -ResourceName MyVirtualNetwork -ResourceGroupName TestResourceGroup
-# View the results of $virtualNetwork and change 'mysubnet' in the following line to the appropriate subnet name.
-$subnet = $virtualNetwork | Select-Object -ExpandProperty subnets | Where-Object Name -eq 'mysubnet'
-$plsConnection= New-AzPrivateLinkServiceConnection -Name MyPLSConnections -PrivateLinkServiceId '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/TestResourceGroup/providers/Microsoft.Network/privateLinkServices/privateLinkService' -RequestMessage 'Please Approve my request'
-New-AzPrivateEndpoint -Name MyPrivateEndpoint -ResourceGroup TestResourceGroup -Location centralus -PrivateLinkServiceConnection $plsConnection -Subnet $subnet
+$virtualNetwork = Get-AzVirtualNetwork -ResourceName 'myVirtualNetwork' -ResourceGroupName 'myResourceGroup'
+$subnet = $virtualNetwork | Select-Object -ExpandProperty subnets | Where-Object Name -eq 'mySubnet'
+$plsConnection= New-AzPrivateLinkServiceConnection -Name 'MyPLSConnections' -PrivateLinkServiceId '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/privateLinkServices/privateLinkService' -RequestMessage 'Please Approve my request'
+New-AzPrivateEndpoint -Name 'MyPrivateEndpoint' -ResourceGroup 'myResourceGroup' -Location 'centralus' -PrivateLinkServiceConnection $plsConnection -Subnet $subnet
 ```
 
 ## PARAMETERS
 
 ### -AsJob
-Run cmdlet in the background
+
+Run cmdlet as a job in the background.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter
@@ -54,7 +57,8 @@ Accept wildcard characters: False
 ```
 
 ### -ByManualRequest
-Using manual request.
+
+Use manual request to establish the connection.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter
@@ -69,6 +73,7 @@ Accept wildcard characters: False
 ```
 
 ### -DefaultProfile
+
 The credentials, account, tenant, and subscription used for communication with Azure.
 
 ```yaml
@@ -84,7 +89,8 @@ Accept wildcard characters: False
 ```
 
 ### -Force
-Do not ask for confirmation if you want to overwrite a resource
+
+Do not ask for confirmation to overwrite a resource.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter
@@ -99,7 +105,9 @@ Accept wildcard characters: False
 ```
 
 ### -Location
-location.
+
+Specifies a location for the private endpoint. Use [Get-AzLocation](/powershell/module/az.resources/get-azlocation)
+to determine valid values for this parameter.
 
 ```yaml
 Type: System.String
@@ -114,7 +122,8 @@ Accept wildcard characters: False
 ```
 
 ### -Name
-The resource name.
+
+Name of the private endpoint.
 
 ```yaml
 Type: System.String
@@ -129,7 +138,8 @@ Accept wildcard characters: False
 ```
 
 ### -PrivateLinkServiceConnection
-The private link service connection.
+
+The resource ID to connect the private endpoint.
 
 ```yaml
 Type: Microsoft.Azure.Commands.Network.Models.PSPrivateLinkServiceConnection[]
@@ -144,7 +154,8 @@ Accept wildcard characters: False
 ```
 
 ### -ResourceGroupName
-The resource group name.
+
+Specifies the name of the resource group.
 
 ```yaml
 Type: System.String
@@ -159,7 +170,8 @@ Accept wildcard characters: False
 ```
 
 ### -Subnet
-The subnet of the private endpoint
+
+The subnet of the private endpoint.
 
 ```yaml
 Type: Microsoft.Azure.Commands.Network.Models.PSSubnet
@@ -174,8 +186,9 @@ Accept wildcard characters: False
 ```
 
 ### -Tag
+
 Key-value pairs in the form of a hash table. For example:
-@{key0="value0";key1=$null;key2="value2"}
+@{key0='value0';key1=$null;key2='value2'}
 
 ```yaml
 Type: System.Collections.Hashtable
@@ -190,6 +203,7 @@ Accept wildcard characters: False
 ```
 
 ### -Confirm
+
 Prompts you for confirmation before running the cmdlet.
 
 ```yaml
@@ -205,6 +219,7 @@ Accept wildcard characters: False
 ```
 
 ### -WhatIf
+
 Shows what would happen if the cmdlet runs.
 The cmdlet is not run.
 
@@ -221,7 +236,11 @@ Accept wildcard characters: False
 ```
 
 ### CommonParameters
-This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
+-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
+-WarningAction, and -WarningVariable. For more information, see
+[about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters).
 
 ## INPUTS