🩹 [Patch]: Add New-GitHubOrganization function

examples/Organizations/Organization.ps1

@@ -0,0 +1,41 @@
+$orgParam = @{
+    Enterprise   = 'msx'
+    Name         = 'Marius-Test7'
+    Owner        = 'GitHub-Automation'
+    BillingEmail = 'post@msx.no'
+}
+$org = New-GitHubOrganization @orgParam
+
+$installAppParam = @{
+    Enterprise          = 'msx'
+    Organization        = $org.login
+    ClientID            = (Get-GitHubContext).ClientID
+    RepositorySelection = 'all'
+}
+Install-GitHubApp @installAppParam
+
+$updateOrgParam = @{
+    Name                                                  = $org.login
+    Description                                           = 'Test organization created by PowerShell script'
+    Location                                              = 'Oslo, Norway'
+    BillingEmail                                          = 'post@msx.no'
+    Company                                               = 'MSX AS'
+    Email                                                 = 'info@msx.no'
+    Blog                                                  = 'https://msx.no/blog'
+    TwitterUsername                                       = 'msx_no'
+    HasOrganizationProjects                               = $true
+    DefaultRepositoryPermission                           = 'read'
+    MembersCanCreateRepositories                          = $true
+    MembersCanCreatePublicRepositories                    = $true
+    MembersCanCreatePrivateRepositories                   = $true
+    MembersCanCreateInternalRepositories                  = $true
+    MembersCanCreatePages                                 = $true
+    MembersCanCreatePublicPages                           = $true
+    MembersCanCreatePrivatePages                          = $true
+    MembersCanForkPrivateRepositories                     = $true
+    WebCommitSignoffRequired                              = $false
+    SecretScanningPushProtectionEnabledForNewRepositories = $true
+    SecretScanningPushProtectionCustomLinkEnabled         = $false
+    SecretScanningPushProtectionCustomLink                = '<link>'
+}
+Update-GitHubOrganization @updateOrgParam

src/classes/public/Owner/GitHubOwner/GitHubOrganization.ps1

@@ -225,7 +225,7 @@
         $this.MembersCanInviteCollaborators = $Object.members_can_invite_collaborators
         $this.MembersCanCreatePages = $Object.members_can_create_pages
         $this.MembersCanForkPrivateRepositories = $Object.members_can_fork_private_repositories ?? $Object.membersCanForkPrivateRepositories
-        $this.RequireWebCommitSignoff = $Object.web_commit_signoff_required ?? $Object.requiresTwoFactorAuthentication
+        $this.RequireWebCommitSignoff = $Object.web_commit_signoff_required ?? $Object.webCommitSignoffRequired
         $this.DeployKeysEnabledForRepositories = $Object.deploy_keys_enabled_for_repositories
         $this.MembersCanCreatePublicPages = $Object.members_can_create_public_pages
         $this.MembersCanCreatePrivatePages = $Object.members_can_create_private_pages

src/functions/private/Apps/GitHub Apps/Install-GitHubAppOnEnterpriseOrganization.ps1

@@ -11,6 +11,7 @@
         .EXAMPLE
         Install-GitHubAppOnEnterpriseOrganization -Enterprise 'msx' -Organization 'org' -ClientID '123456'
     #>
+    [OutputType([GitHubAppInstallation])]
     [CmdletBinding()]
     param(
         # The enterprise slug or ID.
@@ -29,7 +30,7 @@
         # - all - all repositories that the authenticated GitHub App installation can access.
         # - selected - select specific repositories.
         [Parameter(Mandatory)]
-        [ValidateSet('all', 'selected')]
+        [ValidateSet('All', 'Selected')]
         [string] $RepositorySelection,
 
         # The names of the repositories to which the installation will be granted access.
@@ -49,6 +50,9 @@
     }
 
     process {
+        if ($RepositorySelection) {
+            $RepositorySelection = $RepositorySelection.ToLower()
+        }
         $body = @{
             client_id            = $ClientID
             repository_selection = $RepositorySelection
@@ -64,7 +68,7 @@
         }
 
         Invoke-GitHubAPI @inputObject | ForEach-Object {
-            Write-Output $_.Response
+            [GitHubAppInstallation]::new($_.Response)
         }
     }
 

src/functions/public/API/Invoke-GitHubAPI.ps1

@@ -315,6 +315,10 @@ function Invoke-GitHubAPI {
             }
 
             $exception = @"
+
+----------------------------------
+Context:
+$($Context | Format-List | Out-String)
 ----------------------------------
 Request:
 $([pscustomobject]$APICall | Select-Object -ExcludeProperty Body, Headers | Format-List | Out-String)

src/functions/public/Organization/New-GitHubOrganization.ps1

@@ -0,0 +1,88 @@
+function New-GitHubOrganization {
+    <#
+        .SYNOPSIS
+        Creates a new GitHub organization within a specified enterprise.
+
+        .DESCRIPTION
+        This function creates a new GitHub organization within the specified enterprise.
+
+        .EXAMPLE
+        New-GitHubOrganization -Enterprise 'my-enterprise' -Name 'my-org' -Owner 'user1' -BillingEmail 'billing@example.com'
+
+        .OUTPUTS
+        GitHubOrganization
+
+        .LINK
+        https://psmodule.io/GitHub/Functions/Organization/New-GitHubOrganization/
+    #>
+    [OutputType([GitHubOrganization])]
+    [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Medium')]
+    param(
+        # The name of the enterprise to create the organization in.
+        [Parameter()]
+        [string]$Enterprise,
+
+        # The name of the organization to create.
+        [Parameter(Mandatory)]
+        [string]$Name,
+
+        # The owners of the organization. This should be a list of GitHub usernames.
+        [Parameter(Mandatory)]
+        [string[]]$Owner,
+
+        # The billing email for the organization.
+        [Parameter()]
+        [string]$BillingEmail,
+
+        # The context to run the command in. Used to get the details for the API call.
+        # Can be either a string or a GitHubContext object.
+        [Parameter()]
+        [object] $Context
+    )
+
+    begin {
+        $stackPath = Get-PSCallStackPath
+        Write-Debug "[$stackPath] - Start"
+        $Context = Resolve-GitHubContext -Context $Context
+        Assert-GitHubContext -Context $Context -AuthType IAT, PAT, UAT
+    }
+
+    process {
+        $enterpriseObject = Get-GitHubEnterprise -Name $Enterprise -Context $Context
+        Write-Verbose "Creating organization in enterprise: $($enterpriseObject.Name)"
+        $graphQLFields = ([GitHubOrganization]::PropertyToGraphQLMap).Values
+
+        $inputParams = @{
+            adminLogins  = $Owner
+            billingEmail = $BillingEmail
+            enterpriseId = $enterpriseObject.NodeID
+            login        = $Name
+            profileName  = $Name
+        }
+
+        $updateGraphQLInputs = @{
+            Query     = @"
+mutation(`$input:CreateEnterpriseOrganizationInput!) {
+    createEnterpriseOrganization(input:`$input) {
+        organization {
+            $graphQLFields
+        }
+    }
+}
+"@
+            Variables = @{
+                input = $inputParams
+            }
+            Context   = $Context
+        }
+        if ($PSCmdlet.ShouldProcess("Creating organization '$Name' in enterprise '$Enterprise'")) {
+            $orgresult = Invoke-GitHubGraphQLQuery @updateGraphQLInputs
+            [GitHubOrganization]::new($orgresult.createEnterpriseOrganization.organization, $Context)
+        }
+    }
+
+    end {
+        Write-Debug "[$stackPath] - End"
+    }
+}
+

src/functions/public/Organization/Remove-GitHubOrganization.ps1

@@ -24,16 +24,16 @@
         https://psmodule.io/GitHub/Functions/Organization/Remove-GitHubOrganization
     #>
     [OutputType([void])]
-    [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'High')]
+    [CmdletBinding(DefaultParameterSetName = 'Remove an organization', SupportsShouldProcess, ConfirmImpact = 'High')]
     param(
         # The organization name. The name is not case sensitive.
-        [Parameter(
-            Mandatory,
-            ValueFromPipeline,
-            ValueFromPipelineByPropertyName
-        )]
+        [Parameter(Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName)]
         [string] $Name,
 
+        # The input object to process. Can be a single or an array of GitHubOrganization objects.
+        [Parameter(Mandatory, ParameterSetName = 'ArrayInput', ValueFromPipeline)]
+        [GitHubOrganization[]] $InputObject,
+
         # The context to run the command in. Used to get the details for the API call.
         # Can be either a string or a GitHubContext object.
         [Parameter()]
@@ -48,20 +48,32 @@
     }
 
     process {
-        $inputObject = @{
-            Method      = 'DELETE'
-            APIEndpoint = "/orgs/$Name"
-            Context     = $Context
-        }
+        switch ($PSCmdlet.ParameterSetName) {
+            'ArrayInput' {
+                foreach ($item in $InputObject) {
+                    $params = @{
+                        Name    = $item.Name
+                        Context = $Context
+                    }
+                    Remove-GitHubOrganization @params
+                }
+                break
+            }
+            default {
+                $apiParams = @{
+                    Method      = 'DELETE'
+                    APIEndpoint = "/orgs/$Name"
+                    Context     = $Context
+                }
 
-        if ($PSCmdlet.ShouldProcess("organization [$Name]", 'DELETE')) {
-            $null = Invoke-GitHubAPI @inputObject
+                if ($PSCmdlet.ShouldProcess("organization [$Name]", 'Delete')) {
+                    $null = Invoke-GitHubAPI @apiParams
+                }
+            }
         }
     }
 
     end {
         Write-Debug "[$stackPath] - End"
     }
 }
-
-#SkipTest:FunctionTest:Will add a test for this function in a future PR