GitHubRepositories: Add Additional Parameters

GitHubRepositories.ps1

@@ -40,8 +40,15 @@ function New-GitHubRepository
         This is only valid when creating a repository in an organization.
 
     .PARAMETER Private
-        By default, this repository will created Public.  Specify this to create
-        a private repository.
+        By default, this repository will be created Public.  Specify this to create a private
+        repository. This parameter controls the same setting as the 'Visibility' parameter and only
+        one should be specified. This parameter will be deprecated in a future release.
+
+    .PARAMETER Visibility
+        Specifies the visibility level of the repository. This controls the same setting as
+        the 'Private' parameter and only one should be specified. Internal is only available if
+        your organization is associated with an enterprise account using GitHub Enterprise Cloud
+        or GitHub Enterprise Server 2.20+
 
     .PARAMETER NoIssues
         By default, this repository will support Issues.  Specify this to disable Issues.
@@ -69,6 +76,12 @@ function New-GitHubRepository
         By default, rebase-merge pull requests will be allowed.
         Specify this to disallow.
 
+    .PARAMETER DeleteBranchOnMerge
+        Specifies the automatic deleting of head branches when pull requests are merged.
+
+    .PARAMETER IsTemplate
+        Specifies whether the repository is made available as a template.
+
     .PARAMETER AccessToken
         If provided, this will be used as the AccessToken for authentication with the
         REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.
@@ -106,6 +119,9 @@ function New-GitHubRepository
 
         [switch] $Private,
 
+        [ValidateSet('Public', 'Private', 'Internal')]
+        [string] $Visibility,
+
         [switch] $NoIssues,
 
         [switch] $NoProjects,
@@ -120,6 +136,10 @@ function New-GitHubRepository
 
         [switch] $DisallowRebaseMerge,
 
+        [switch] $DeleteBranchOnMerge,
+
+        [switch] $IsTemplate,
+
         [string] $AccessToken,
 
         [switch] $NoStatus
@@ -131,6 +151,24 @@ function New-GitHubRepository
         'RepositoryName' = (Get-PiiSafeString -PlainText $RepositoryName)
     }
 
+    if ($PSBoundParameters.ContainsKey('Private'))
+    {
+        Write-Log -Level Warning -Message ('The Private switch is being replaced by the Visibility parameter.  ' +
+            'Please update any scripts/usage that you may have to migrate to the Visibility parameter, ' +
+            'as the Private switch will be replaced in a future update.')
+
+        if ($PSBoundParameters.ContainsKey('Visibility'))
+        {
+            if (($Private -and ($Visibility -ne 'Private')) -or ((-not $Private) -and ($Visibility -ne 'Public')))
+            {
+                $message = ('The Private and Visibility parameters control the same repo property.  ' +
+                    'If both are specified, their values must be the same.')
+                Write-Log -Message $message -Level Error
+                throw $message
+            }
+        }
+    }
+
     $uriFragment = 'user/repos'
     if ($PSBoundParameters.ContainsKey('OrganizationName') -and
         (-not [String]::IsNullOrEmpty($OrganizationName)))
@@ -156,19 +194,23 @@ function New-GitHubRepository
     if ($PSBoundParameters.ContainsKey('LicenseTemplate')) { $hashBody['license_template'] = $LicenseTemplate }
     if ($PSBoundParameters.ContainsKey('TeamId')) { $hashBody['team_id'] = $TeamId }
     if ($PSBoundParameters.ContainsKey('Private')) { $hashBody['private'] = $Private.ToBool() }
+    if ($PSBoundParameters.ContainsKey('Visibility')) { $hashBody['visibility'] = $Visibility.ToLower() }
     if ($PSBoundParameters.ContainsKey('NoIssues')) { $hashBody['has_issues'] = (-not $NoIssues.ToBool()) }
     if ($PSBoundParameters.ContainsKey('NoProjects')) { $hashBody['has_projects'] = (-not $NoProjects.ToBool()) }
     if ($PSBoundParameters.ContainsKey('NoWiki')) { $hashBody['has_wiki'] = (-not $NoWiki.ToBool()) }
     if ($PSBoundParameters.ContainsKey('AutoInit')) { $hashBody['auto_init'] = $AutoInit.ToBool() }
     if ($PSBoundParameters.ContainsKey('DisallowSquashMerge')) { $hashBody['allow_squash_merge'] = (-not $DisallowSquashMerge.ToBool()) }
     if ($PSBoundParameters.ContainsKey('DisallowMergeCommit')) { $hashBody['allow_merge_commit'] = (-not $DisallowMergeCommit.ToBool()) }
     if ($PSBoundParameters.ContainsKey('DisallowRebaseMerge')) { $hashBody['allow_rebase_merge'] = (-not $DisallowRebaseMerge.ToBool()) }
+    if ($PSBoundParameters.ContainsKey('DeleteBranchOnMerge')) { $hashBody['delete_branch_on_merge'] = $DeleteBranchOnMerge.ToBool() }
+    if ($PSBoundParameters.ContainsKey('IsTemplate')) { $hashBody['is_template'] = $IsTemplate.ToBool() }
 
     $params = @{
         'UriFragment' = $uriFragment
         'Body' = (ConvertTo-Json -InputObject $hashBody)
         'Method' = 'Post'
-        'Description' =  "Creating $RepositoryName"
+        'AcceptHeader' = "$script:nebulaAcceptHeader,$script:baptisteAcceptHeader"
+        'Description' = "Creating $RepositoryName"
         'AccessToken' = $AccessToken
         'TelemetryEventName' = $MyInvocation.MyCommand.Name
         'TelemetryProperties' = $telemetryProperties
@@ -717,8 +759,16 @@ function Update-GitHubRepository
         Update the default branch for this repository.
 
     .PARAMETER Private
-        Specify this to make the repository private.
-        To change a repository to be public, specify -Private:$false
+        Specify this to make the repository private. To change a repository to be public,
+        specify -Private:$false.  This parameter controls the same setting as the 'Visibility'
+        parameter and only one should be specified. This parameter will be deprecated in a future
+        release.
+
+    .PARAMETER Visibility
+        Specifies the visibility level of the repository. This controls the same setting as
+        the 'Private' parameter and only one should be specified. Internal is only available if
+        your organization is associated with an enterprise account using GitHub Enterprise Cloud
+        or GitHub Enterprise Server 2.20+
 
     .PARAMETER NoIssues
         By default, this repository will support Issues.  Specify this to disable Issues.
@@ -743,6 +793,12 @@ function Update-GitHubRepository
         By default, rebase-merge pull requests will be allowed.
         Specify this to disallow.
 
+    .PARAMETER DeleteBranchOnMerge
+        Specifies the automatic deleting of head branches when pull requests are merged.
+
+    .PARAMETER IsTemplate
+        Specifies whether the repository is made available as a template.
+
     .PARAMETER Archived
         Specify this to archive this repository.
         NOTE: You cannot unarchive repositories through the API / this module.
@@ -787,6 +843,9 @@ function Update-GitHubRepository
 
         [switch] $Private,
 
+        [ValidateSet('Public', 'Private', 'Internal')]
+        [string] $Visibility,
+
         [switch] $NoIssues,
 
         [switch] $NoProjects,
@@ -799,6 +858,10 @@ function Update-GitHubRepository
 
         [switch] $DisallowRebaseMerge,
 
+        [switch] $DeleteBranchOnMerge,
+
+        [switch] $IsTemplate,
+
         [switch] $Archived,
 
         [string] $AccessToken,
@@ -817,6 +880,24 @@ function Update-GitHubRepository
         'RepositoryName' = (Get-PiiSafeString -PlainText $RepositoryName)
     }
 
+    if ($PSBoundParameters.ContainsKey('Private'))
+    {
+        Write-Log -Level Warning -Message ('The Private switch is being replaced by the Visibility parameter.  ' +
+            'Please update any scripts/usage that you may have to migrate to the Visibility parameter, ' +
+            'as the Private switch will be replaced in a future update.')
+
+        if ($PSBoundParameters.ContainsKey('Visibility'))
+        {
+            if (($Private -and ($Visibility -ne 'Private')) -or ((-not $Private) -and ($Visibility -ne 'Public')))
+            {
+                $message = ('The Private and Visibility parameters control the same repo property.  ' +
+                    'If both are specified, their values must be the same.')
+                Write-Log -Message $message -Level Error
+                throw $message
+            }
+        }
+    }
+
     $hashBody = @{
         'name' = $RepositoryName
     }
@@ -825,12 +906,15 @@ function Update-GitHubRepository
     if ($PSBoundParameters.ContainsKey('Homepage')) { $hashBody['homepage'] = $Homepage }
     if ($PSBoundParameters.ContainsKey('DefaultBranch')) { $hashBody['default_branch'] = $DefaultBranch }
     if ($PSBoundParameters.ContainsKey('Private')) { $hashBody['private'] = $Private.ToBool() }
+    if ($PSBoundParameters.ContainsKey('Visibility')) { $hashBody['visibility'] = $Visibility.ToLower() }
     if ($PSBoundParameters.ContainsKey('NoIssues')) { $hashBody['has_issues'] = (-not $NoIssues.ToBool()) }
     if ($PSBoundParameters.ContainsKey('NoProjects')) { $hashBody['has_projects'] = (-not $NoProjects.ToBool()) }
     if ($PSBoundParameters.ContainsKey('NoWiki')) { $hashBody['has_wiki'] = (-not $NoWiki.ToBool()) }
     if ($PSBoundParameters.ContainsKey('DisallowSquashMerge')) { $hashBody['allow_squash_merge'] = (-not $DisallowSquashMerge.ToBool()) }
     if ($PSBoundParameters.ContainsKey('DisallowMergeCommit')) { $hashBody['allow_merge_commit'] = (-not $DisallowMergeCommit.ToBool()) }
     if ($PSBoundParameters.ContainsKey('DisallowRebaseMerge')) { $hashBody['allow_rebase_merge'] = (-not $DisallowRebaseMerge.ToBool()) }
+    if ($PSBoundParameters.ContainsKey('DeleteBranchOnMerge')) { $hashBody['delete_branch_on_merge'] = $DeleteBranchOnMerge.ToBool() }
+    if ($PSBoundParameters.ContainsKey('IsTemplate')) { $hashBody['is_template'] = $IsTemplate.ToBool() }
     if ($PSBoundParameters.ContainsKey('Archived')) { $hashBody['archived'] = $Archived.ToBool() }
 
     $params = @{