fix md files

Author: QingChenmsft

src/ResourceManager/ServiceFabric/ChangeLog.md

@@ -0,0 +1,56 @@
+<!--
+    Please leave this section at the top of the change log.
+
+    Changes for the current release should go under the section titled "Current Release", and should adhere to the following format:
+
+    ## Current Release
+    * Overview of change #1
+        - Additional information about change #1
+    * Overview of change #2
+        - Additional information about change #2
+        - Additional information about change #2
+    * Overview of change #3
+    * Overview of change #4
+        - Additional information about change #4
+
+    ## YYYY.MM.DD - Version X.Y.Z (Previous Release)
+    * Overview of change #1
+        - Additional information about change #1
+-->
+## Current Release
+
+## Version 0.1.0
+* Added cmdlets for service fabric
+* New cmdlet
+    - Add-AzureRmServiceFabricApplicationCertificate
+        Add a certificate which will be used as application certificate
+    - Add-AzureRmServiceFabricClientCertificate
+        Add a common name or thumbprint to the cluster settings for client authentication
+    - Add-AzureRmServiceFabricClusterCertificate
+        Add a secondary cluster certificate to the cluster for rolling over the existing certificate
+    - Add-AzureRmServiceFabricNodes
+        Add nodes/VMs of a specific node type to a cluster
+    - Add-AzureRmServiceFabricNodeType
+        Add a node type/VMs to an existing cluster
+    - Get-AzureRmServiceFabricCluster
+        Get the details of the cluster resource
+    - New-AzureRmServiceFabricCluster
+        Create a new ServiceFabric cluster. This command has many overloads to cover various scenarios
+    - Remove-AzureRmServiceFabricClientCertificate
+        Remove a client certificate from being used to access a cluster
+    - Remove-AzureRmServiceFabricClusterCertificate
+        Remove a cluster certificate from being used for cluster security
+    - Remove-AzureRmServiceFabricNodes
+        Remove nodes from a specific node type from a cluster
+    - Remove-AzureRmServiceFabricNodeType
+        Remove a node type from a cluster
+    - Remove-AzureRmServiceFabricSettings
+        Remove one or more ServiceFabric settings from a cluster
+    - Set-AzureRmServiceFabricSettings
+        Add or update one or more ServiceFabric settings of a cluster
+    - Set-AzureRmServiceFabricUpgradeType
+        Change the ServiceFabric upgrade type of a cluster
+    - Update-AzureRmServiceFabricDurability
+        Change the durability tier of a cluster
+    - Update-AzureRmServiceFabricReliability
+        Change the reliability tier of a cluster

src/ResourceManager/ServiceFabric/Commands.ServiceFabric/Commands/NewAzureRmServiceFabricCluster.cs

@@ -157,20 +157,20 @@ public override string KeyVaultResouceGroupLocation
         public virtual SecureString SecondaryCertificatePassword { get; set; }
 
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByNewPfxAndVaultName,
-              HelpMessage = "Azure key vault resource group name, it not given it will be same as resource group name")]
+              HelpMessage = "Azure key vault resource group name, it not given it will be defaulted to resource group name")]
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByExistingPfxAndVaultName,
-              HelpMessage = "Azure key vault resource group name, it not given it will be same as resource group name")]
+              HelpMessage = "Azure key vault resource group name, it not given it will be defaulted to resource group name")]
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByDefaultArmTemplate,
-              HelpMessage = "Azure key vault resource group name, it not given it will be same as resource group name")]
+              HelpMessage = "Azure key vault resource group name, it not given it will be defaulted to resource group name")]
         [ValidateNotNullOrEmpty]
         public override string KeyVaultResouceGroupName { get; set; }
 
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByNewPfxAndVaultName,
-                HelpMessage = "Azure key vault name, it not given it will be same as resource group name")]
+                HelpMessage = "Azure key vault name, it not given it will be defaulted to the resource group name")]
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByExistingPfxAndVaultName,
-                HelpMessage = "Azure key vault name, it not given it will be same as resource group name")]
+                HelpMessage = "Azure key vault name, it not given it will be defaulted to the resource group name")]
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByDefaultArmTemplate,
-                HelpMessage = "Azure key vault name, it not given it will be same as resource group name")]
+                HelpMessage = "Azure key vault name, it not given it will be defaulted to the resource group name")]
         [ValidateNotNullOrEmpty]
         public override string KeyVaultName { get; set; }
 
@@ -234,7 +234,7 @@ public override string CertificateSubjectName
 
         private OperatingSystem os = OperatingSystem.WindowsServer2016Datacenter;
         [Parameter(Mandatory = false, ParameterSetName = ByDefaultArmTemplate, ValueFromPipelineByPropertyName = true,
-                   HelpMessage = "The OS type of the cluster")]
+                   HelpMessage = "The Operating System of the VMs that make up the cluster.")]
         [Alias("VmImage")]
         public OperatingSystem OS
         {

src/ResourceManager/ServiceFabric/Commands.ServiceFabric/Commands/ServiceFabricClusterCertificateCmdlet.cs

@@ -73,47 +73,47 @@ public abstract class ServiceFabricClusterCertificateCmdlet : ServiceFabricClust
         public override string Name { get; set; }
 
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByNewPfxAndVaultName,
-            HelpMessage = "Azure key vault resource group name")]
+            HelpMessage = "Azure key vault resource group name, it not given it will be defaulted to resource group name")]
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByExistingPfxAndVaultName,
-            HelpMessage = "Azure key vault resource group name")]
+            HelpMessage = "Azure key vault resource group name, it not given it will be defaulted to resource group name")]
         [ValidateNotNullOrEmpty]
         public virtual string KeyVaultResouceGroupName { get; set; }
 
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByNewPfxAndVaultName,
-                   HelpMessage = "Azure key vault name")]
+                   HelpMessage = "Azure key vault name, it not given it will be defaulted to the resource group name")]
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByExistingPfxAndVaultName,
-                   HelpMessage = "Azure key vault name")]
+                   HelpMessage = "Azure key vault name, it not given it will be defaulted to the resource group name")]
         [ValidateNotNullOrEmpty]
         public virtual string KeyVaultName { get; set; }
 
         [Parameter(Mandatory = true, ValueFromPipeline = true, ParameterSetName = ExistingKeyVault,
-                   HelpMessage = "The existing Azure key vault secret URL")]
+                   HelpMessage = "The existing Azure key vault secret URL, for example 'https://mykv.vault.azure.net:443/secrets/mysecrets/55ec7c4dc61a462bbc645ffc9b4b225f'")]
         [ValidateNotNullOrEmpty]
         public string SecretIdentifier { get; set; }
 
         [Parameter(Mandatory = true, ValueFromPipeline = true, ParameterSetName = ByExistingPfxAndVaultName,
-                   HelpMessage = "The existing certificate file path")]
+                   HelpMessage = "The path to the existing certificate")]
         [ValidateNotNullOrEmpty]
         [Alias("Source")]
         public virtual string CertificateFile { get; set; }
 
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByNewPfxAndVaultName,
-                   HelpMessage = "The folder path of the new certificate to be created")]
+                   HelpMessage = "The folder where the new certificate needs to be downloaded.")]
         [ValidateNotNullOrEmpty]
         [Alias("Destination")]
         public virtual string CertificateOutputFolder { get; set; }
 
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByExistingPfxAndVaultName,
-                   HelpMessage = "The password of the certificate file")]
+                   HelpMessage = "The password of the certificate")]
         [Parameter(Mandatory = false, ValueFromPipeline = true, ParameterSetName = ByNewPfxAndVaultName,
-                   HelpMessage = "The password of the certificate file")]
+                   HelpMessage = "The password of the certificate")]
         [ValidateNotNullOrEmpty]
         [Alias("CertPassword")]
         public virtual SecureString CertificatePassword { get; set; }
 
         private string certificateSubjectName;
         [Parameter(Mandatory = true, ValueFromPipeline = true, ParameterSetName = ByNewPfxAndVaultName,
-            HelpMessage = "The subject name of the certificate to be created")]
+            HelpMessage = "The subject name of the certificate")]
         [ValidateNotNullOrEmpty]
         [Alias("Subject")]
         public virtual string CertificateSubjectName

src/ResourceManager/ServiceFabric/Commands.ServiceFabric/help/Add-AzureRmServiceFabricApplicationCertificate.md

@@ -40,21 +40,50 @@ You can specify a certificate you already have or have the system generate an ne
 
 ### Example 1
 ```
-PS c:> Add-AzureRmServiceFabricApplicationCertificate -ResourceGroupName 'Group1' -ClusterName 'Contoso01SFCluster' -SecretIdentifier 'https://contoso03vault.vault.azure.net/secrets/contoso03vaultrg/7f7de9131c034172b9df37ccc549524f'
+PS c:> Add-AzureRmServiceFabricApplicationCertificate -ResourceGroupName 'Group1' -Name 'Contoso01SFCluster' -SecretIdentifier 'https://contoso03vault.vault.azure.net/secrets/contoso03vaultrg/7f7de9131c034172b9df37ccc549524f'
 ```
 
 This command will add a certificate from existing Azure key vault to all node types of the cluster named Contoso01SFCluster
 
 ### Example 2
 ```
-PS c:\> $pwd = ConvertTo-SecureString -String "123" -AsPlainText -Force
-PS C:\> Add-AzureRmServiceFabricApplicationCertificate -ResourceGroupName 'Group2' -ClusterName 'Contoso02SFCluster' -KeyVaultName 'Contoso02Vault' -KeyVaultResouceGroupName 'Contoso02VaultRg'
+PS c:\> $pwd = ConvertTo-SecureString -String '123' -AsPlainText -Force
+PS C:\> Add-AzureRmServiceFabricApplicationCertificate -ResourceGroupName 'Group2' -Name 'Contoso02SFCluster' -KeyVaultName 'Contoso02Vault' -KeyVaultResouceGroupName 'Contoso02VaultRg'
+        -CertificateSubjectName 'cn=Contoso.com' -CertificateOutputFolder 'c:\test' -CertificatePassword $pwd
 ```
 
-This command will add certificate by creating an new self signed certificate and uploading to Azure key vault, then installs to all node types of the cluster
+This command will create certificate in Azure key vault, then installs to all node types of the cluster, and download the certificate to c:\test
 
 ## PARAMETERS
 
+### -CertificateFile
+The existing certificate file path
+
+```yaml
+Type: String
+Parameter Sets: ByExistingPfxAndVaultName
+Aliases: Source
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -CertificateOutputFolder
+The folder path of the new certificate to be created```yaml
+Type: String
+Parameter Sets: ByNewPfxAndVaultName
+Aliases: Destination
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
 ### -CertificatePassword
 The password of the pfx file
 
@@ -144,7 +173,7 @@ Accept wildcard characters: False
 ```
 
 ### -ResourceGroupName
-Specifies the name of the resource group.
+Specify the name of the resource group.
 
 ```yaml
 Type: String
@@ -188,32 +217,6 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -CertificateFile
-The existing certificate file path```yaml
-Type: String
-Parameter Sets: ByExistingPfxAndVaultName
-Aliases: Source
-
-Required: True
-Position: Named
-Default value: None
-Accept pipeline input: True (ByValue)
-Accept wildcard characters: False
-```
-
-### -CertificateOutputFolder
-The folder path of the new certificate to be created```yaml
-Type: String
-Parameter Sets: ByNewPfxAndVaultName
-Aliases: Destination
-
-Required: False
-Position: Named
-Default value: None
-Accept pipeline input: True (ByValue)
-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).