@@ -227,6 +227,175 @@ filter New-GitHubRepository

return (Invoke-GHRestMethod @params | Add-GitHubRepositoryAdditionalProperties)

}

filter New-GitHubRepositoryFromTemplate

{

<#

.SYNOPSIS

Creates a new repository on GitHub from a template repository.

.DESCRIPTION

Creates a new repository on GitHub from a template repository.

The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

.PARAMETER OwnerName

Owner of the template repository.

If no value is specified, the DefaultOwnerName configuration property value will be used,

and if there is no configuration value defined, the current authenticated user will be used.

.PARAMETER RepositoryName

Name of the template repository.

.PARAMETER Uri

Uri for the repository.

The OwnerName and RepositoryName will be extracted from here instead of needing to provide

them individually.

.PARAMETER TargetOwnerName

The organization or person who will own the new repository.

To create a new repository in an organization, the authenticated user must be a member

of the specified organization.

.PARAMETER TargetRepositoryName

Name of the repository to be created.

.PARAMETER Description

A short description of the repository.

.PARAMETER Private

By default, this repository will created Public. Specify this to create a private

repository.

.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.

.PARAMETER NoStatus

If this switch is specified, long-running commands will run on the main thread

with no commandline status update. When not specified, those commands run in

the background, enabling the command prompt to provide status information.

If not supplied here, the DefaultNoStatus configuration property value will be used.

.INPUTS

GitHub.Branch

GitHub.Content

GitHub.Event

GitHub.Issue

GitHub.IssueComment

GitHub.Label

GitHub.Milestone

GitHub.PullRequest

GitHub.Project

GitHub.ProjectCard

GitHub.ProjectColumn

GitHub.Release

GitHub.Repository

.OUTPUTS

GitHub.Repository

.NOTES

The authenticated user must own or be a member of an organization that owns the repository.

To check if a repository is available to use as a template, call `Get-GitHubRepository` on the

repository in question and check that the is_template property is $true.

.EXAMPLE

New-GitHubRepositoryFromTemplate -OwnerName MyOrg -RepositoryName MyTemplateRepo -TargetRepositoryName MyNewRepo -TargetOwnerName Me

Creates a new GitHub repository from the specified template repository.

.EXAMPLE

$repo = Get-GitHubRepository -OwnerName MyOrg -RepositoryName MyTemplateRepo

$repo | New-GitHubRepositoryFromTemplate -TargetRepositoryName MyNewRepo -TargetOwnerName Me

You can also pipe in a repo that was returned from a previous command.

#>

[CmdletBinding(

SupportsShouldProcess,

PositionalBinding = $false)]

[OutputType({$script:GitHubRepositoryTypeName})]

[Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "",

Justification="Methods called within here make use of PSShouldProcess, and the switch is

passed on to them inherently.")]

param(

[Parameter(ParameterSetName = 'Elements')]

[string] $OwnerName,

[Parameter(

Mandatory,

Position = 1,

ParameterSetName = 'Elements')]

[ValidateNotNullOrEmpty()]

[string] $RepositoryName,

[Parameter(

Mandatory,

Position = 2,

ValueFromPipelineByPropertyName,

ParameterSetName = 'Uri')]

[Alias('RepositoryUrl')]

[string] $Uri,

[Parameter(

Mandatory,

Position = 3)]

[ValidateNotNullOrEmpty()]

[string] $TargetOwnerName,

[Parameter(

Mandatory,

Position = 4)]

[ValidateNotNullOrEmpty()]

[string] $TargetRepositoryName,

[string] $Description,

[switch] $Private,

[string] $AccessToken,

[switch] $NoStatus

)

Write-InvocationLog

$elements = Resolve-RepositoryElements -BoundParameters $PSBoundParameters

$OwnerName = $elements.ownerName

$telemetryProperties = @{

RepositoryName = (Get-PiiSafeString -PlainText $RepositoryName)

OwnerName = (Get-PiiSafeString -PlainText $OwnerName)

TargetRepositoryName = (Get-PiiSafeString -PlainText $TargetRepositoryName)

TargetOwnerName = (Get-PiiSafeString -PlainText $TargetOwnerName)

}

$uriFragment = "repos/$OwnerName/$RepositoryName/generate"

$hashBody = @{

owner = $TargetOwnerName

name = $TargetRepositoryName

}

if ($PSBoundParameters.ContainsKey('Description')) { $hashBody['description'] = $Description }

if ($PSBoundParameters.ContainsKey('Private')) { $hashBody['private'] = $Private.ToBool() }

$params = @{

'UriFragment' = $uriFragment

'Body' = (ConvertTo-Json -InputObject $hashBody)

'Method' = 'Post'

'Description' = "Creating $TargetRepositoryName from Template"

'AcceptHeader' = $script:baptisteAcceptHeader

'AccessToken' = $AccessToken

'TelemetryEventName' = $MyInvocation.MyCommand.Name

'TelemetryProperties' = $telemetryProperties

'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue `

-BoundParameters $PSBoundParameters -Name NoStatus -ConfigValueName DefaultNoStatus)

}

return (Invoke-GHRestMethod @params | Add-GitHubRepositoryAdditionalProperties)

}

filter Remove-GitHubRepository

{

<#