Merge pull request #225036 from HeidiSteen/heidist-rbac

[azure search] Updated links for create-service

Author: prmerger-automator[bot]

articles/search/search-create-service-portal.md

@@ -8,7 +8,7 @@ author: HeidiSteen
 ms.author: heidist
 ms.service: cognitive-search
 ms.topic: conceptual
-ms.date: 10/13/2022
+ms.date: 01/25/2023
 ---
 
 # Create an Azure Cognitive Search service in the portal
@@ -17,7 +17,7 @@ ms.date: 10/13/2022
 
 If you have an Azure subscription, including a [trial subscription](https://azure.microsoft.com/pricing/free-trial/?WT.mc_id=A261C142F), you can create a search service for free. Free services have limitations, but you can complete all of the quickstarts and most tutorials.
 
-The easiest way to create search service is using the [Azure portal](https://portal.azure.com/), which is covered in this article. You can also use [Azure PowerShell](search-manage-powershell.md), [Azure CLI](/cli/azure/search), the [Management REST API](/rest/api/searchmanagement/), an [Azure Resource Manager service template](https://azure.microsoft.com/resources/templates/azure-search-create/), or a [Bicep file](search-get-started-bicep.md).
+The easiest way to create search service is using the [Azure portal](https://portal.azure.com/), which is covered in this article. You can also use [Azure PowerShell](search-manage-powershell.md#create-or-delete-a-service), [Azure CLI](search-manage-azure-cli.md#create-or-delete-a-service), the [Management REST API](search-manage-rest.md#create-or-update-a-service), an [Azure Resource Manager service template](search-get-started-arm.md), or a [Bicep file](search-get-started-bicep.md).
 
 [![Animated GIF](./media/search-create-service-portal/AnimatedGif-AzureSearch-small.gif)](./media/search-create-service-portal/AnimatedGif-AzureSearch.gif#lightbox)
 
@@ -26,18 +26,16 @@ The easiest way to create search service is using the [Azure portal](https://por
 The following service properties are fixed for the lifetime of the service. Because they're fixed, consider the usage implications as you fill in each property:
 
 + Service name becomes part of the URL endpoint ([review tips for helpful service names](#name-the-service)).
-+ [Tier](search-sku-tier.md) (Basic, Standard, and so forth) determines the underlying physical hardware and billing. Some features are tier-constrained.
++ [Tier](search-sku-tier.md) (Free, Basic, Standard, and so forth) determines the underlying physical hardware and billing. Some features are tier-constrained.
 + [Service region](#choose-a-region) can determine the availability of certain scenarios. If you need high availability or [AI enrichment](cognitive-search-concept-intro.md), you'll need to create the resource in a region that provides the feature. 
 
 ## Subscribe (free or paid)
 
-To try search for free, you have two options:
+To try search for free, [open a free Azure account](https://azure.microsoft.com/pricing/free-trial/?WT.mc_id=A261C142F) and then create your search service using the **Free** tier. Because the tier is fixed, it will never transition to become a billable tier.
 
-+ [Open a free Azure account](https://azure.microsoft.com/pricing/free-trial/?WT.mc_id=A261C142F) and use free credits to try out paid Azure services. After credits are used up, keep the account and continue to use free Azure services, such as Websites. Your credit card is never charged unless you explicitly change your settings and ask to be charged.
+Alternatively, you can use free credits to try out paid Azure services, which means you can create your search service at **Basic** or above to get more capacity. Your credit card is never charged unless you explicitly change your settings and ask to be charged. Another approach is to [activate Azure credits in a Visual Studio subscription](https://azure.microsoft.com/pricing/member-offers/msdn-benefits-details/?WT.mc_id=A261C142F). A Visual Studio subscription gives you credits every month you can use for paid Azure services. 
 
-+ Alternatively, [activate Azure credits in a Visual Studio subscription](https://azure.microsoft.com/pricing/member-offers/msdn-benefits-details/?WT.mc_id=A261C142F). A Visual Studio subscription gives you credits every month you can use for paid Azure services. 
-
-Paid (or billable) search becomes effective when you choose a billable tier (Basic or above) when creating the resource.
+Paid (or billable) search occurs when you choose a billable tier (Basic or above) when creating the resource on a billable Azure subscription.
 
 ## Find the Azure Cognitive Search offering
 

articles/search/search-manage-azure-cli.md

@@ -8,7 +8,7 @@ ms.author: magottei
 ms.service: cognitive-search
 ms.devlang: azurecli
 ms.topic: how-to
-ms.date: 01/05/2023
+ms.date: 01/25/2023
 ---
 
 # Manage your Azure Cognitive Search service with the Azure CLI
@@ -151,6 +151,13 @@ Results should look similar to the following output:
 }
 ```
 
+[**az search service delete**](/cli/azure/search/service#az-search-service-delete-required-parameters) removes the service and its data.
+
+```azurecli-interactive
+az search service delete --name <service-name> \
+                         --resource-group  <search-service-resource-group-name> \
+```
+
 ### Create a service with IP rules
 
 Depending on your security requirements, you may want to create a search service with an [IP firewall configured](service-configure-firewall.md). To do so, pass the Public IP (v4) addresses or CIDR ranges to the `ip-rules` argument as shown below. Rules should be separated by a comma (`,`) or semicolon (`;`).

articles/search/search-manage-powershell.md

@@ -9,7 +9,7 @@ ms.author: heidist
 ms.service: cognitive-search
 ms.devlang: powershell
 ms.topic: how-to
-ms.date: 06/08/2022
+ms.date: 01/25/2023
 ms.custom: devx-track-azurepowershell
 ---
 
@@ -193,9 +193,10 @@ ResourceId        : /subscriptions/<alphanumeric-subscription-ID>/resourceGroups
 ```azurepowershell-interactive
 New-AzSearchService -ResourceGroupName <resource-group-name> -Name <search-service-name> -Sku "Standard" -Location "West US" -PartitionCount 3 -ReplicaCount 3 -HostingMode Default
 ``` 
+
 Results should look similar to the following output.
 
-```
+```azurepowershell
 ResourceGroupName : demo-westus
 Name              : my-demo-searchapp
 Id                : /subscriptions/<alphanumeric-subscription-ID>/demo-westus/providers/Microsoft.Search/searchServices/my-demo-searchapp
@@ -207,6 +208,21 @@ HostingMode       : Default
 Tags
 ```     
 
+[**Remove-AzSearchService**](/powershell/module/az.search/remove-azsearchservice) is used to delete a service and its data.
+
+```azurepowershell-interactive
+Remove-AzSearchService -ResourceGroupName <resource-group-name> -Name <search-service-name>
+``` 
+
+You'll be asked to confirm the action.
+
+```azurepowershell
+Confirm
+Are you sure you want to remove Search Service 'pstestazuresearch01'?
+[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y
+```
+
+
 ### Create a service with IP rules
 
 Depending on your security requirements, you may want to create a search service with an [IP firewall configured](service-configure-firewall.md). To do so, first define the IP Rules and then pass them to the `IPRuleList` parameter as shown below.