SP 2013 - Use PowerShell to Add a Custom Web Part to a Page

Question

Hello Community,
I need to add a custom web part to a page using PowerShell - has anyone done this and if so please provide guidance and code examples.
Thanks!
Tom
Tom Molskow - Senior SharePoint Architect - Microsoft Community Contributor 2011 and 2012 Award -
Linked-In - SharePoint Gypsy

Answer 1

BTW, here is my current code:
#$web= Get-SPWeb -Identity "http://c4968397007/sites/BRE"
$Url = "http://c4968397007/sites/BRE"
$pageUrl = "/SitePages/Home"
$webpartzone = 2
$index = 0
$fileName = "wp_DistrictHomePage_VisualWebPart1.webpart"
$web = Get-SPWeb $Url
$web.AllowUnsafeUpdates=$true
 $webPartGallery = $web.Lists["Web Part Gallery"]
 Write-Host "Searching webpart $fileName in web part gallery"
  if($webPartGallery -eq $null)
   Write-Host("Unable to retrieve Webpartgallery");
 $webpart = $null;
 $webpart=$webPartGallery.Items | ? { $_.Title -eq $fileName}
  if($webpart -eq $null) {
   Write-Host("Unable to retrieve webpart: $fileName") -ForegroundColor Red
 else {
  Write-Host("----------Adding Webpart--------")-ForegroundColor Yellow
  $webpartmanager=$web.GetLimitedWebPartManager($pageUrl, [System.Web.UI.WebControls.WebParts.PersonalizationScope]::Shared)
  $errorMsg = "";
  $xmlReader = New-Object System.Xml.XmlTextReader($webpart.File.OpenBinaryStream());
  $webpart = $webpartmanager.ImportWebPart($xmlReader,[ref]"Error")
  $webpartmanager.AddWebPart($webpart, $webpartzone, $index);
  Write-Host("Webpart is added successfully") -ForegroundColor Green ;
$SiteURL =$Url
#---------------Test Page----------------------------
$PageName="Test.aspx"
$page=$web.lists["Pages"].Items | ? {$_.Name -eq $PageName}
$page.File.CheckOut();
Add-WebPartToPage "$SiteURL/Pages/$PageName" "Header" 0 "My Custom WebPart"
$page.File.CheckIn("Added Web part to a page");
$page.File.Approve("Added Web part to a page");
Tom Molskow - Senior SharePoint Architect - Microsoft Community Contributor 2011 and 2012 Award -
Linked-In - SharePoint Gypsy