Update help files.

Author: Chang Lu

src/Search/Search/Az.Search.psd1

@@ -84,7 +84,9 @@ CmdletsToExport = 'Get-AzSearchAdminKeyPair', 'Get-AzSearchPrivateEndpointConnec
                'Remove-AzSearchSharedPrivateLinkResource', 
                'Set-AzSearchPrivateEndpointConnection', 'Set-AzSearchService', 
                'Set-AzSearchSharedPrivateLinkResource',
-               'Get-AzSearchNetworkSecurityPerimeterConfiguration'
+               'Get-AzSearchNetworkSecurityPerimeterConfiguration',
+               'Reconcile-AzSearchNetworkSecurityPerimeterConfiguration',
+               'Upgrade-AzSearchService'
 
 # Variables to export from this module
 # VariablesToExport = @()

src/Search/Search/SearchService/UpgradeSearchServiceCommand.cs

@@ -0,0 +1,87 @@
+// ----------------------------------------------------------------------------------
+//
+// Copyright Microsoft Corporation
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ----------------------------------------------------------------------------------
+
+using Microsoft.Azure.Commands.ResourceManager.Common.ArgumentCompleters;
+using Microsoft.Azure.Management.Internal.Resources.Utilities.Models;
+using Microsoft.Rest.Azure;
+using System;
+using System.Management.Automation;
+using System.Net;
+
+namespace Microsoft.Azure.Commands.Management.Search.SearchService
+{
+    [Cmdlet("Upgrade", ResourceManager.Common.AzureRMConstants.AzureRMPrefix + "SearchService", DefaultParameterSetName = ResourceGroupParameterSetName), OutputType(typeof(bool))]
+    public class UpgradeSearchServiceCommand : SearchServiceBaseCmdlet
+    {
+        [Parameter(
+            Position = 0,
+            Mandatory = true,
+            ParameterSetName = ResourceGroupParameterSetName,
+            HelpMessage = ResourceGroupHelpMessage)]
+        [ValidateNotNullOrEmpty]
+        [ResourceGroupCompleter()]
+        public string ResourceGroupName { get; set; }
+
+        [Parameter(
+            Position = 1,
+            Mandatory = true,
+            ParameterSetName = ResourceGroupParameterSetName,
+            HelpMessage = ResourceNameHelpMessage)]
+        [ValidateNotNullOrEmpty]
+        public string Name { get; set; }
+
+        [Parameter(
+            Position = 0,
+            Mandatory = true,
+            ParameterSetName = ResourceIdParameterSetName,
+            ValueFromPipelineByPropertyName = true,
+            HelpMessage = ResourceIdHelpMessage)]
+        [ValidateNotNullOrEmpty]
+        public string ResourceId { get; set; }
+
+        [Parameter(Mandatory = false, HelpMessage = PassThruHelpMessage)]
+        public SwitchParameter PassThru { get; set; }
+
+        public override void ExecuteCmdlet()
+        {
+            if (ParameterSetName.Equals(ResourceIdParameterSetName, StringComparison.InvariantCulture))
+            {
+                var id = new ResourceIdentifier(ResourceId);
+                ResourceGroupName = id.ResourceGroupName;
+                Name = id.ResourceName;
+            }
+
+            try
+            {
+                SearchClient.Services.UpgradeWithHttpMessagesAsync(ResourceGroupName, Name).Wait();
+
+                if (PassThru)
+                {
+                    WriteObject(true);
+                }
+            }
+            catch (AggregateException ae)
+            {
+                if (ae.InnerException is CloudException
+                    && ((CloudException)ae.InnerException).Response?.StatusCode == HttpStatusCode.NotFound)
+                {
+                    // the method throws an exception when the service does not exist.
+                    return;
+                }
+
+                throw ae.InnerException;
+            }
+        }
+    }
+}

src/Search/Search/help/Az.Search.md

@@ -12,56 +12,56 @@ This topic displays help topics for the Azure AI Search Cmdlets.
 
 ## Az.Search Cmdlets
 ### [Get-AzSearchAdminKeyPair](Get-AzSearchAdminKeyPair.md)
-Gets admin key pair of the Azure AI Search service.
+Gets admin key pair of the Azure Cognitive Search service.
+
+### [Get-AzSearchNetworkSecurityPerimeterConfiguration](Get-AzSearchNetworkSecurityPerimeterConfiguration.md)
+Gets an Azure AI Search service network security perimeter configuration.
 
 ### [Get-AzSearchPrivateEndpointConnection](Get-AzSearchPrivateEndpointConnection.md)
-Gets private endpoint connection(s) to the Azure AI Search service.
+Gets private endpoint connection(s) to the Azure Cognitive Search service.
 
 ### [Get-AzSearchPrivateLinkResource](Get-AzSearchPrivateLinkResource.md)
-Gets private link resource details for the Azure AI Search service.
+Gets private link resource details for the Azure Cognitive Search service.
 
 ### [Get-AzSearchQueryKey](Get-AzSearchQueryKey.md)
-Gets query key(s) of the Azure AI Search service.
+Gets query key(s) of the Azure Cognitive Search service.
 
 ### [Get-AzSearchService](Get-AzSearchService.md)
-Gets an Azure AI Search service.
+Gets an Azure Cognitive Search service.
 
 ### [Get-AzSearchSharedPrivateLinkResource](Get-AzSearchSharedPrivateLinkResource.md)
-Gets shared private link resources(s) of the Azure AI Search service.
+Gets shared private link resources(s) of the Azure Cognitive Search service.
 
 ### [New-AzSearchAdminKey](New-AzSearchAdminKey.md)
-Regenerates an admin key of the Azure AI Search service.
+Regenerates an admin key of the Azure Cognitive Search service.
 
 ### [New-AzSearchQueryKey](New-AzSearchQueryKey.md)
-Create a new query key for the Azure AI Search service.
+Create a new query key for the Azure Cognitive Search service.
 
 ### [New-AzSearchService](New-AzSearchService.md)
-Creates an Azure AI Search service.
+Creates an Azure Cognitive Search service.
 
 ### [New-AzSearchSharedPrivateLinkResource](New-AzSearchSharedPrivateLinkResource.md)
-Creates a shared private link resource for the Azure AI Search service.
+Creates a shared private link resource for the Azure Cognitive Search service.
 
 ### [Remove-AzSearchPrivateEndpointConnection](Remove-AzSearchPrivateEndpointConnection.md)
-Remove the private endpoint connection from the Azure AI Search service.
+Remove the private endpoint connection from the Azure Cognitive Search service.
 
 ### [Remove-AzSearchQueryKey](Remove-AzSearchQueryKey.md)
-Remove the query key from the Azure AI Search service.
+Remove the query key from the Azure Cognitive Search service.
 
 ### [Remove-AzSearchService](Remove-AzSearchService.md)
-Remove an Azure AI Search service.
+Remove an Azure Cognitive Search service.
 
 ### [Remove-AzSearchSharedPrivateLinkResource](Remove-AzSearchSharedPrivateLinkResource.md)
-Remove the shared private link resource from the Azure AI Search service.
+Remove the shared private link resource from the Azure Cognitive Search service.
 
 ### [Set-AzSearchPrivateEndpointConnection](Set-AzSearchPrivateEndpointConnection.md)
-Update the private endpoint connection to the Azure AI Search service.
+Update the private endpoint connection to the Azure Cognitive Search service.
 
 ### [Set-AzSearchService](Set-AzSearchService.md)
-Update an Azure AI Search service.
+Update an Azure Cognitive Search service.
 
 ### [Set-AzSearchSharedPrivateLinkResource](Set-AzSearchSharedPrivateLinkResource.md)
-Update the shared private link resource for the Azure AI Search service.
-
-### [Get-AzSearchNetworkSecurityPerimeterConfiguration](Get-AzSearchNetworkSecurityPerimeterConfiguration.md)
-Gets an Azure AI Search service network security perimeter configuration.
+Update the shared private link resource for the Azure Cognitive Search service.
 

src/Search/Search/help/Get-AzSearchAdminKeyPair.md

@@ -15,19 +15,19 @@ Gets admin key pair of the Azure Cognitive Search service.
 ### ResourceNameParameterSet (Default)
 ```
 Get-AzSearchAdminKeyPair [-ResourceGroupName] <String> [-ServiceName] <String>
- [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
+ [-DefaultProfile <IAzureContextContainer>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ### ParentObjectParameterSet
 ```
 Get-AzSearchAdminKeyPair [-ParentObject] <PSSearchService> [-DefaultProfile <IAzureContextContainer>]
- [<CommonParameters>]
+ [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ### ParentResourceIdParameterSet
 ```
 Get-AzSearchAdminKeyPair [-ParentResourceId] <String> [-DefaultProfile <IAzureContextContainer>]
- [<CommonParameters>]
+ [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -95,6 +95,21 @@ Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```
 
+### -ProgressAction
+{{ Fill ProgressAction Description }}
+
+```yaml
+Type: System.Management.Automation.ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -ResourceGroupName
 Resource Group name.
 

src/Search/Search/help/Get-AzSearchNetworkSecurityPerimeterConfiguration.md

@@ -12,10 +12,10 @@ Gets an Azure AI Search service network security perimeter configuration.
 
 ## SYNTAX
 
-### ResourceGroupParameterSet (Default)
 ```
-Get-AzSearchNetworkSecurityPerimeterConfiguration [-ResourceGroupName] <String> [-ServiceName] <String> [[-Name] <String>]
-[-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
+Get-AzSearchNetworkSecurityPerimeterConfiguration [-ResourceGroupName] <String> [-ServiceName] <String>
+ [[-Name] <String>] [-DefaultProfile <IAzureContextContainer>] [-ProgressAction <ActionPreference>] [-WhatIf]
+ [-Confirm] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -80,12 +80,42 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -Name
+Azure AI Search Service network security perimeter configuration name
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ProgressAction
+{{ Fill ProgressAction Description }}
+
+```yaml
+Type: System.Management.Automation.ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -ResourceGroupName
 Resource Group name.
 
 ```yaml
 Type: System.String
-Parameter Sets: ResourceNameParameterSet
+Parameter Sets: (All)
 Aliases:
 
 Required: True
@@ -100,7 +130,7 @@ Azure AI Search Service name.
 
 ```yaml
 Type: System.String
-Parameter Sets: ResourceNameParameterSet
+Parameter Sets: (All)
 Aliases:
 
 Required: True
@@ -110,21 +140,35 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -Name
-Azure AI Search Service network security perimeter configuration name
+### -Confirm
+Prompts you for confirmation before running the cmdlet.
 
 ```yaml
-Type: System.String
-Parameter Sets: ResourceNameParameterSet
-Aliases:
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: (All)
+Aliases: cf
 
 Required: False
-Position: 2
+Position: Named
 Default value: None
 Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -WhatIf
+Shows what would happen if the cmdlet runs. The cmdlet is not run.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: (All)
+Aliases: wi
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+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).

src/Search/Search/help/Get-AzSearchPrivateEndpointConnection.md

@@ -15,19 +15,21 @@ Gets private endpoint connection(s) to the Azure Cognitive Search service.
 ### ResourceNameParameterSet (Default)
 ```
 Get-AzSearchPrivateEndpointConnection [-ResourceGroupName] <String> [-ServiceName] <String> [[-Name] <String>]
- [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]
+ [-DefaultProfile <IAzureContextContainer>] [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm]
+ [<CommonParameters>]
 ```
 
 ### ParentObjectParameterSet
 ```
 Get-AzSearchPrivateEndpointConnection [-ParentObject] <PSSearchService> [[-Name] <String>]
- [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]
+ [-DefaultProfile <IAzureContextContainer>] [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm]
+ [<CommonParameters>]
 ```
 
 ### ResourceIdParameterSet
 ```
 Get-AzSearchPrivateEndpointConnection [-ResourceId] <String> [-DefaultProfile <IAzureContextContainer>]
- [-WhatIf] [-Confirm] [<CommonParameters>]
+ [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -117,6 +119,21 @@ Accept pipeline input: True (ByValue)
 Accept wildcard characters: False
 ```
 
+### -ProgressAction
+{{ Fill ProgressAction Description }}
+
+```yaml
+Type: System.Management.Automation.ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -ResourceGroupName
 Resource Group name.