From 8ab2a4f53235ba06e150865c7bd8b0bfb3a7d2fc Mon Sep 17 00:00:00 2001
From: Anam Navied <anam.naviyou@gmail.com>
Date: Tue, 5 Jul 2022 18:51:45 -0400
Subject: [PATCH 1/4] add help docs for New,Update,Test-PSScriptFileInfo
 cmdlets

---
 help/New-PSScriptFileInfo.md    | 385 ++++++++++++++++++++++++++++++
 help/Test-PSScriptFileInfo.md   |  79 +++++++
 help/Update-PSScriptFileInfo.md | 403 ++++++++++++++++++++++++++++++++
 3 files changed, 867 insertions(+)
 create mode 100644 help/New-PSScriptFileInfo.md
 create mode 100644 help/Test-PSScriptFileInfo.md
 create mode 100644 help/Update-PSScriptFileInfo.md

diff --git a/help/New-PSScriptFileInfo.md b/help/New-PSScriptFileInfo.md
new file mode 100644
index 000000000..f3a9ac431
--- /dev/null
+++ b/help/New-PSScriptFileInfo.md
@@ -0,0 +1,385 @@
+---
+external help file: PowerShellGet-help.xml
+Module Name: PowerShellGet
+online version: 
+schema: 2.0.0
+---
+
+# New-PSScriptFileInfo
+
+## SYNOPSIS
+
+Creates a new .ps1 file containing metadata for the script, which is used when publishing a script package.
+
+## SYNTAX
+
+### __AllParameterSets
+
+```
+New-PSScriptFileInfo [-FilePath] <String> -Description <String> [-Author <String>] [-CompanyName <String>] [-Copyright <String>] [-ExternalModuleDependencies <String[]>] [-ExternalScriptDependencies <String[]>] [-Force] [-Guid <Guid>] [-IconUri <String>] [-LicenseUri <String>] [-PrivateData <String>] [-ProjectUri <String>] [-ReleaseNotes <String[]>] [-RequiredModules <Hashtable[]>] [-RequiredScripts <String[]>] [-Tags <String[]>] [-Version <String>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+The New-PSScriptFileInfo cmdlet creates a .ps1 file containing metadata for the script.
+
+## EXAMPLES
+
+### Example 1: Example 1
+
+```
+PS C:\> {{ Add example code here }}
+```
+
+{{ Add example description here }}
+
+## PARAMETERS
+
+### -Author
+
+The author of the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -CompanyName
+
+The name of the company owning the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -Copyright
+
+The copyright information for the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -Description
+
+The description of the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: True
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -ExternalModuleDependencies
+
+The list of external module dependencies taken by this script.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -ExternalScriptDependencies
+
+The list of external script dependencies taken by this script.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -FilePath
+
+The path the .ps1 script info file will be created at.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: True
+Position: 0
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -Force
+
+If used and the .ps1 file specified at the path exists, it rewrites the file.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -Guid
+
+The GUID for the script.
+
+```yaml
+Type: Guid
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -IconUri
+
+The Uri for the icon associated with the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -LicenseUri
+
+The Uri for the license associated with the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -PrivateData
+
+The private data associated with the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -ProjectUri
+
+The Uri for the project associated with the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -ReleaseNotes
+
+The release notes for the script.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -RequiredModules
+
+The list of modules required by the script.
+
+```yaml
+Type: Hashtable[]
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -RequiredScripts
+
+The list of scripts required by the script.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: True (None) False (All)
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -Tags
+
+The tags associated with the script.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: True (None) False (All)
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -Version
+
+The version of the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: True (None) False (All)
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: 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).
+
+## INPUTS
+
+### None
+
+
+
+## OUTPUTS
+
+### None
+
+
+
+## NOTES
+
+
+## RELATED LINKS
+
+Fill Related Links Here
+
diff --git a/help/Test-PSScriptFileInfo.md b/help/Test-PSScriptFileInfo.md
new file mode 100644
index 000000000..5780e5b73
--- /dev/null
+++ b/help/Test-PSScriptFileInfo.md
@@ -0,0 +1,79 @@
+---
+external help file: PowerShellGet-help.xml
+Module Name: PowerShellGet
+online version: 
+schema: 2.0.0
+---
+
+# Test-PSScriptFileInfo
+
+## SYNOPSIS
+
+Tests a .ps1 file at the specified path to ensure it is valid.
+
+## SYNTAX
+
+### __AllParameterSets
+
+```
+Test-PSScriptFileInfo [-FilePath] <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+The Test-PSScriptFileInfo cmdlet tests a .ps1 file at the specified path to ensure it is valid.
+
+## EXAMPLES
+
+### Example 1: Example 1
+
+```
+PS C:\> {{ Add example code here }}
+```
+
+{{ Add example description here }}
+
+## PARAMETERS
+
+### -FilePath
+
+The path the .ps1 script info file will be created at.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: True
+Position: 0
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: 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).
+
+## INPUTS
+
+### None
+
+
+
+## OUTPUTS
+
+### bool
+
+
+
+## NOTES
+
+
+## RELATED LINKS
+
+Fill Related Links Here
+
diff --git a/help/Update-PSScriptFileInfo.md b/help/Update-PSScriptFileInfo.md
new file mode 100644
index 000000000..40edca293
--- /dev/null
+++ b/help/Update-PSScriptFileInfo.md
@@ -0,0 +1,403 @@
+---
+external help file: PowerShellGet-help.xml
+Module Name: PowerShellGet
+online version: 
+schema: 2.0.0
+---
+
+# Update-PSScriptFileInfo
+
+## SYNOPSIS
+
+Updates an existing .ps1 file with requested properties and ensures it's valid
+
+## SYNTAX
+
+### __AllParameterSets
+
+```
+Update-PSScriptFileInfo [-FilePath] <String> [-Author <String>] [-CompanyName <String>] [-Copyright <String>] [-Description <String>] [-ExternalModuleDependencies <String[]>] [-ExternalScriptDependencies <String[]>] [-Force] [-Guid <Guid>] [-IconUri <String>] [-LicenseUri <String>] [-PrivateData <String>] [-ProjectUri <String>] [-ReleaseNotes <String[]>] [-RemoveSignature] [-RequiredModules <Hashtable[]>] [-RequiredScripts <String[]>] [-Tags <String[]>] [-Version <String>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+The Update-PSScriptFileInfo cmdlet updates an existing .ps1 file with requested properties and ensures it's valid.
+
+## EXAMPLES
+
+### Example 1: Example 1
+
+```
+PS C:\> {{ Add example code here }}
+```
+
+{{ Add example description here }}
+
+## PARAMETERS
+
+### -Author
+
+The author of the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -CompanyName
+
+The name of the company owning the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -Copyright
+
+The copyright information for the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -Description
+
+The description of the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -ExternalModuleDependencies
+
+The list of external module dependencies taken by this script.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -ExternalScriptDependencies
+
+The list of external script dependencies taken by this script.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -FilePath
+
+The path the .ps1 script info file will be created at.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: True
+Position: 0
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -Force
+
+If used with FilePath parameter and .ps1 file specified at the path exists, it rewrites the file
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -Guid
+
+The GUID for the script.
+
+```yaml
+Type: Guid
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -IconUri
+
+The Uri for the icon associated with the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -LicenseUri
+
+The Uri for the license associated with the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -PrivateData
+
+The private data associated with the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -ProjectUri
+
+The Uri for the project associated with the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -ReleaseNotes
+
+The release notes for the script.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -RemoveSignature
+
+Remove signature from signed .ps1 (if present) thereby allowing update of script to happen. User should re-sign the updated script afterwards.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -RequiredModules
+
+The list of modules required by the script.
+
+```yaml
+Type: Hashtable[]
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -RequiredScripts
+
+The list of scripts required by the script.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -Tags
+
+The tags associated with the script.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -Version
+
+The version of the script.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: False
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: 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).
+
+## INPUTS
+
+### None
+
+
+
+## OUTPUTS
+
+### None
+
+
+
+## NOTES
+
+
+## RELATED LINKS
+
+Fill Related Links Here
+

From 9d4873b91683a642d3ed1894792fc866e205d204 Mon Sep 17 00:00:00 2001
From: Anam Navied <anam.naviyou@gmail.com>
Date: Wed, 6 Jul 2022 00:22:18 -0400
Subject: [PATCH 2/4] add examples to help doc for New-PSScriptFileInfo cmdlet

---
 help/New-PSScriptFileInfo.md | 106 ++++++++++++++++++++++++++++++++++-
 1 file changed, 103 insertions(+), 3 deletions(-)

diff --git a/help/New-PSScriptFileInfo.md b/help/New-PSScriptFileInfo.md
index f3a9ac431..2a5d04bce 100644
--- a/help/New-PSScriptFileInfo.md
+++ b/help/New-PSScriptFileInfo.md
@@ -25,13 +25,113 @@ The New-PSScriptFileInfo cmdlet creates a .ps1 file containing metadata for the
 
 ## EXAMPLES
 
-### Example 1: Example 1
+### Example 1: Creating a script with minimum required parameters
 
 ```
-PS C:\> {{ Add example code here }}
+PS C:\> New-PSScriptFileInfo -FilePath "C:\Users\johndoe\MyScripts\test_script.ps1" -Description "this is a test script"
+PS C:\> cat "C:\Users\johndoe\MyScripts\test_script.ps1"
+<#PSScriptInfo
+
+.VERSION 1.0.0.0
+
+.GUID 6ec3934e-a2e0-495b-9a9c-480e555ad1d1
+
+.AUTHOR johndoe
+
+.COMPANYNAME
+
+.COPYRIGHT
+
+.TAGS
+
+.LICENSEURI
+
+.PROJECTURI
+
+.ICONURI
+
+.EXTERNALMODULEDEPENDENCIES 
+
+.REQUIREDSCRIPTS 
+
+.EXTERNALSCRIPTDEPENDENCIES 
+
+.RELEASENOTES
+
+
+.PRIVATEDATA
+
+
+#>
+
+<#
+
+.DESCRIPTION
+this is a test script
+
+
+#>
+        
+```
+
+This example runs the cmdlet with the only required parameters, the 'FilePath' parameter sets the path the script is to be created and the 'Description' parameter contains the description for the script. The script is successfully created and if the contents of the file are viewed we can see the Description set as well as Author, Guid, and Version (with default values).
+
+### Example 2: Creating a script with RequiredModules, Author, Version parameters
+
 ```
+PS C:\> $requiredModules =  @(@{ModuleName = "PackageManagement"; ModuleVersion = "1.0.0.0" }, @{ModuleName = "PSReadLine"})
+PS C:\> New-PSScriptFileInfo -FilePath "C:\Users\johndoe\MyScripts\test_script.ps1" -Description "this is a test script" -Version "2.0.0.0" -Author "janedoe" -RequiredModules $requiredModules
+PS C:\> cat "C:\Users\johndoe\MyScripts\test_script.ps1"
+<#PSScriptInfo
+
+.VERSION 2.0.0.0
+
+.GUID 7ec4832e-a4e1-562b-8a8c-241e535ad7d7
+
+.AUTHOR janedoe
+
+.COMPANYNAME Jane Corporation
+
+.COPYRIGHT
+
+.TAGS
+
+.LICENSEURI
+
+.PROJECTURI
+
+.ICONURI
+
+.EXTERNALMODULEDEPENDENCIES 
+
+.REQUIREDSCRIPTS 
+
+.EXTERNALSCRIPTDEPENDENCIES 
+
+.RELEASENOTES
+
+
+.PRIVATEDATA
+
+
+#>
+
+#Requires -Module PSReadLine
+#Requires -Module @{ ModuleName = 'PackageManagement'; ModuleVersion = '1.0.0.0' }
+
+<#
+
+.DESCRIPTION
+this is a test script
+
+
+#>
+        
+```
+
+This example runs the cmdlet with the required 'FilePath' and 'Description' parameters, as well as 'Author', 'Version', and 'RequiredModules' parameters. The 'RequiredModules' parameter describes modules required by the script. It is necessary to provide the ModuleName key in the hashtable and if one wishes to specify verion they must also specify ModuleVersion, RequiredVersion, MaximumVersion, or MinimumVersion keys. The script is successfully created and if the contents of the file are viewed we can see the following values are set in the script file: Description, Author, Guid, and Version and RequiredModules.
+
 
-{{ Add example description here }}
 
 ## PARAMETERS
 

From 36c7487230da6a693fab377cfb81f9c03b127166 Mon Sep 17 00:00:00 2001
From: Anam Navied <anam.naviyou@gmail.com>
Date: Wed, 6 Jul 2022 10:28:01 -0400
Subject: [PATCH 3/4] add examples to help doc for
 New,Update,Test-PSScriptFileInfo cmdlets

---
 help/New-PSScriptFileInfo.md    |   4 +-
 help/Test-PSScriptFileInfo.md   | 108 ++++++++++++++++++++++++++++++--
 help/Update-PSScriptFileInfo.md |  50 ++++++++++++++-
 3 files changed, 153 insertions(+), 9 deletions(-)

diff --git a/help/New-PSScriptFileInfo.md b/help/New-PSScriptFileInfo.md
index 2a5d04bce..083893a2a 100644
--- a/help/New-PSScriptFileInfo.md
+++ b/help/New-PSScriptFileInfo.md
@@ -76,11 +76,11 @@ this is a test script
 
 This example runs the cmdlet with the only required parameters, the 'FilePath' parameter sets the path the script is to be created and the 'Description' parameter contains the description for the script. The script is successfully created and if the contents of the file are viewed we can see the Description set as well as Author, Guid, and Version (with default values).
 
-### Example 2: Creating a script with RequiredModules, Author, Version parameters
+### Example 2: Creating a script with RequiredModules, Author, Version and Description parameters
 
 ```
 PS C:\> $requiredModules =  @(@{ModuleName = "PackageManagement"; ModuleVersion = "1.0.0.0" }, @{ModuleName = "PSReadLine"})
-PS C:\> New-PSScriptFileInfo -FilePath "C:\Users\johndoe\MyScripts\test_script.ps1" -Description "this is a test script" -Version "2.0.0.0" -Author "janedoe" -RequiredModules $requiredModules
+PS C:\> New-PSScriptFileInfo -FilePath "C:\Users\johndoe\MyScripts\test_script2.ps1" -Description "this is a test script" -Version "2.0.0.0" -Author "janedoe" -RequiredModules $requiredModules
 PS C:\> cat "C:\Users\johndoe\MyScripts\test_script.ps1"
 <#PSScriptInfo
 
diff --git a/help/Test-PSScriptFileInfo.md b/help/Test-PSScriptFileInfo.md
index 5780e5b73..7335c7a42 100644
--- a/help/Test-PSScriptFileInfo.md
+++ b/help/Test-PSScriptFileInfo.md
@@ -25,19 +25,119 @@ The Test-PSScriptFileInfo cmdlet tests a .ps1 file at the specified path to ensu
 
 ## EXAMPLES
 
-### Example 1: Example 1
+### Example 1: Test a valid script
 
 ```
-PS C:\> {{ Add example code here }}
+PS C:\> New-PSScriptFileInfo -FilePath "C:\Users\johndoe\MyScripts\test_script.ps1" -Description "this is a test script"
+PS C:\> Test-PSScriptFileInfo -FilePath "C:\Users\johndoe\MyScripts\test_script.ps1"
+True
+PS C:\> cat "C:\Users\johndoe\MyScripts\test_script.ps1"
+<#PSScriptInfo
+
+.VERSION 1.0.0.0
+
+.GUID 6ec3934e-a2e0-495b-9a9c-480e555ad1d1
+
+.AUTHOR johndoe
+
+.COMPANYNAME
+
+.COPYRIGHT
+
+.TAGS
+
+.LICENSEURI
+
+.PROJECTURI
+
+.ICONURI
+
+.EXTERNALMODULEDEPENDENCIES 
+
+.REQUIREDSCRIPTS 
+
+.EXTERNALSCRIPTDEPENDENCIES 
+
+.RELEASENOTES
+
+
+.PRIVATEDATA
+
+
+#>
+
+<#
+
+.DESCRIPTION
+this is a test script
+
+
+#>
+
+```
+
+Assume that the script file specified was created by the New-PSScriptFileInfo cmdlet prior to this example and is valid. This example runs the Test-PSScriptFileInfo cmdlet against a script located at the path provided to the 'FilePath' parameter. Since the script is a valid script the cmdlet outputs "True". To see what this valid script looks like we can see the contents of the file.
+
+### Example 2: Test an invalid script (missing Author)
+
 ```
+PS C:\> Test-PSScriptFileInfo -FilePath "C:\Users\johndoe\MyScripts\invalid_test_script.ps1"
+WARNING: The .ps1 script file passed in was not valid due to: PSScript file is missing the required Author property
+False
+
+PS C:\> cat "C:\Users\johndoe\MyScripts\test_script.ps1"
+<#PSScriptInfo
+
+.VERSION 1.0.0.0
+
+.GUID 7ec4832e-a4e1-562b-8a8c-241e535ad7d7
+
+.AUTHOR
+
+.COMPANYNAME
+
+.COPYRIGHT
+
+.TAGS
+
+.LICENSEURI
+
+.PROJECTURI
+
+.ICONURI
+
+.EXTERNALMODULEDEPENDENCIES 
+
+.REQUIREDSCRIPTS 
+
+.EXTERNALSCRIPTDEPENDENCIES 
+
+.RELEASENOTES
+
+
+.PRIVATEDATA
+
+
+#>
+
+<#
+
+.DESCRIPTION
+this is a test script
+
+
+#>
+
+```
+
+This example runs the Test-PSScriptFileInfo cmdlet against a script located at the path provided to the 'FilePath' parameter. Since the script is not a valid script and is missing the required Author metadata property, the cmdlet writes an informative warning message and outputs "False". To see what this invalid script looks like we can see the contents of the file.
 
-{{ Add example description here }}
 
 ## PARAMETERS
 
 ### -FilePath
 
-The path the .ps1 script info file will be created at.
+The path that the .ps1 script info file which is to be tested is located at.
 
 ```yaml
 Type: String
diff --git a/help/Update-PSScriptFileInfo.md b/help/Update-PSScriptFileInfo.md
index 40edca293..65f1a55b8 100644
--- a/help/Update-PSScriptFileInfo.md
+++ b/help/Update-PSScriptFileInfo.md
@@ -25,13 +25,57 @@ The Update-PSScriptFileInfo cmdlet updates an existing .ps1 file with requested
 
 ## EXAMPLES
 
-### Example 1: Example 1
+### Example 1: Update the version of a script
 
 ```
-PS C:\> {{ Add example code here }}
+PS C:\> New-PSScriptFileInfo -FilePath "C:\Users\johndoe\MyScripts\test_script.ps1" -Version "1.0.0.0" -Description "this is a test script"
+PS C:\> Update-PSScriptFileInfo -FilePath "C:\Users\johndoe\MyScripts\test_script.ps1" -Version "2.0.0.0"
+PS C:\> cat "C:\Users\johndoe\MyScripts\test_script.ps1"
+<#PSScriptInfo
+
+.VERSION 2.0.0.0
+
+.GUID 6ec3934e-a2e0-495b-9a9c-480e555ad1d1
+
+.AUTHOR johndoe
+
+.COMPANYNAME
+
+.COPYRIGHT
+
+.TAGS
+
+.LICENSEURI
+
+.PROJECTURI
+
+.ICONURI
+
+.EXTERNALMODULEDEPENDENCIES 
+
+.REQUIREDSCRIPTS 
+
+.EXTERNALSCRIPTDEPENDENCIES 
+
+.RELEASENOTES
+
+
+.PRIVATEDATA
+
+
+#>
+
+<#
+
+.DESCRIPTION
+this is a test script
+
+
+#>
+
 ```
 
-{{ Add example description here }}
+In this example a script is created by running the New-PSScriptFileInfo cmdlet with version specified as 1.0.0.0. To update the script's version to 2.0.0.0, the Update-PSScriptFileInfo cmdlet is run with 'Version' specified as "2.0.0.0". Given that the cmdlet completed running without errors and by looking at the contents of the updated file we see the version was updated to 2.0.0.0.
 
 ## PARAMETERS
 

From 695d4ec6abb82d200085bb5b7c0fd30e67458f50 Mon Sep 17 00:00:00 2001
From: Anam Navied <anam.naviyou@gmail.com>
Date: Wed, 6 Jul 2022 10:46:31 -0400
Subject: [PATCH 4/4] remove Force parameter from Update help docs

---
 help/Update-PSScriptFileInfo.md | 20 +-------------------
 1 file changed, 1 insertion(+), 19 deletions(-)

diff --git a/help/Update-PSScriptFileInfo.md b/help/Update-PSScriptFileInfo.md
index 65f1a55b8..740c0eaeb 100644
--- a/help/Update-PSScriptFileInfo.md
+++ b/help/Update-PSScriptFileInfo.md
@@ -16,7 +16,7 @@ Updates an existing .ps1 file with requested properties and ensures it's valid
 ### __AllParameterSets
 
 ```
-Update-PSScriptFileInfo [-FilePath] <String> [-Author <String>] [-CompanyName <String>] [-Copyright <String>] [-Description <String>] [-ExternalModuleDependencies <String[]>] [-ExternalScriptDependencies <String[]>] [-Force] [-Guid <Guid>] [-IconUri <String>] [-LicenseUri <String>] [-PrivateData <String>] [-ProjectUri <String>] [-ReleaseNotes <String[]>] [-RemoveSignature] [-RequiredModules <Hashtable[]>] [-RequiredScripts <String[]>] [-Tags <String[]>] [-Version <String>] [<CommonParameters>]
+Update-PSScriptFileInfo [-FilePath] <String> [-Author <String>] [-CompanyName <String>] [-Copyright <String>] [-Description <String>] [-ExternalModuleDependencies <String[]>] [-ExternalScriptDependencies <String[]>] [-Guid <Guid>] [-IconUri <String>] [-LicenseUri <String>] [-PrivateData <String>] [-ProjectUri <String>] [-ReleaseNotes <String[]>] [-RemoveSignature] [-RequiredModules <Hashtable[]>] [-RequiredScripts <String[]>] [-Tags <String[]>] [-Version <String>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -205,24 +205,6 @@ Accept wildcard characters: False
 DontShow: False
 ```
 
-### -Force
-
-If used with FilePath parameter and .ps1 file specified at the path exists, it rewrites the file
-
-```yaml
-Type: SwitchParameter
-Parameter Sets: (All)
-Aliases: 
-Accepted values: 
-
-Required: False
-Position: Named
-Default value: 
-Accept pipeline input: False
-Accept wildcard characters: False
-DontShow: False
-```
-
 ### -Guid
 
 The GUID for the script.