diff --git a/src/GitlabCli/GitlabCli.psd1 b/src/GitlabCli/GitlabCli.psd1 index f1e0aed..9349c78 100644 --- a/src/GitlabCli/GitlabCli.psd1 +++ b/src/GitlabCli/GitlabCli.psd1 @@ -1,5 +1,5 @@ @{ - ModuleVersion = '1.117.2' + ModuleVersion = '1.118.0' RequiredModules = @('powershell-yaml') @@ -27,8 +27,8 @@ ExternalModuleDependencies = @('powershell-yaml') ReleaseNotes = @' -* https://github.com/chris-peterson/pwsh-gitlab/issues/94 -* https://github.com/chris-peterson/pwsh-gitlab/issues/97 +* Wrap pipeline schedule ownership transfer +* Support impersonation session '@ } } @@ -66,6 +66,7 @@ 'Notes.psm1' 'PersonalAccessTokens.psm1' 'Pipelines.psm1' + 'PipelineSchedules.psm1' 'Projects.psm1' 'ProjectHooks.psm1' 'RepositoryFiles.psm1' @@ -202,12 +203,6 @@ 'Get-GitlabPipelineVariable' 'New-GitlabPipeline' 'Remove-GitlabPipeline' - 'Get-GitlabPipelineSchedule' - 'New-GitlabPipelineSchedule' - 'Update-GitlabPipelineSchedule' - 'Enable-GitlabPipelineSchedule' - 'Disable-GitlabPipelineSchedule' - 'Remove-GitlabPipelineSchedule' 'Get-GitlabPipelineScheduleVariable' 'New-GitlabPipelineScheduleVariable' 'Remove-GitlabPipelineScheduleVariable' @@ -215,6 +210,14 @@ 'New-GitlabScheduledPipeline' 'Get-GitlabPipelineBridge' + # Pipeline Schedules + 'Get-GitlabPipelineSchedule' + 'New-GitlabPipelineSchedule' + 'Update-GitlabPipelineSchedule' + 'Enable-GitlabPipelineSchedule' + 'Disable-GitlabPipelineSchedule' + 'Remove-GitlabPipelineSchedule' + # Jobs 'Get-GitlabJob' 'Get-GitlabJobTrace' @@ -250,6 +253,8 @@ 'Get-GitlabUser' 'Get-GitlabCurrentUser' 'Block-GitlabUser' + 'Start-GitlabUserImpersonation' + 'Stop-GitlabUserImpersonation' 'Unblock-GitlabUser' # Events diff --git a/src/GitlabCli/PipelineSchedules.psm1 b/src/GitlabCli/PipelineSchedules.psm1 new file mode 100644 index 0000000..c85af17 --- /dev/null +++ b/src/GitlabCli/PipelineSchedules.psm1 @@ -0,0 +1,507 @@ +function Get-GitlabPipelineSchedule { + + [CmdletBinding(DefaultParameterSetName='ByProjectId')] + [Alias('schedule')] + [Alias('schedules')] + param ( + [Parameter(ParameterSetName='ByProjectId', ValueFromPipelineByPropertyName)] + [Parameter(ParameterSetName='ByPipelineScheduleId')] + [string] + $ProjectId = '.', + + [Parameter(ParameterSetName='ByPipelineScheduleId', Mandatory)] + [Alias('Id')] + [int] + $PipelineScheduleId, + + [Parameter(ParameterSetName='ByProjectId')] + [string] + [ValidateSet('active', 'inactive')] + $Scope, + + [Parameter(ParameterSetName='ByProjectId', ValueFromPipelineByPropertyName)] + [switch] + $IncludeVariables, + + [Parameter()] + [string] + $SiteUrl + ) + + $Project = Get-GitlabProject -ProjectId $ProjectId + + $GitlabApiArguments = @{ + HttpMethod = 'GET' + # https://docs.gitlab.com/ee/api/pipeline_schedules.html#get-all-pipeline-schedules + Path = "projects/$($Project.Id)/pipeline_schedules" + Query = @{} + SiteUrl = $SiteUrl + } + + switch ($PSCmdlet.ParameterSetName) { + ByPipelineScheduleId { + $GitlabApiArguments.Path += "/$PipelineScheduleId" + } + ByProjectId { + if($Scope) { + $GitlabApiArguments.Query.scope = $Scope + } + } + default { throw "Parameterset $($PSCmdlet.ParameterSetName) is not implemented"} + } + + $Wrapper = Invoke-GitlabApi @GitlabApiArguments | New-WrapperObject 'Gitlab.PipelineSchedule' + $Wrapper | Add-Member -NotePropertyMembers @{ Project = $Project } + + if ($IncludeVariables) { + # only returned by the single schedule API so have to fetch them individually + # (https://docs.gitlab.com/ee/api/pipeline_schedules.html#get-a-single-pipeline-schedule) + $Wrapper = $Wrapper | ForEach-Object { Get-GitlabPipelineSchedule -ProjectId $_.ProjectId -PipelineScheduleId $_.Id } + } + + $Wrapper | Sort-Object NextRunAtSortable +} + +# https://docs.gitlab.com/ee/api/pipeline_schedules.html#create-a-new-pipeline-schedule +function New-GitlabPipelineSchedule { + [CmdletBinding(SupportsShouldProcess)] + param ( + [Parameter(ValueFromPipelineByPropertyName)] + [string] + $ProjectId = '.', + + [Parameter(ValueFromPipelineByPropertyName)] + [Alias('Branch')] + [string] + $Ref, + + [Parameter(Mandatory)] + [string] + $Description, + + [Parameter(Mandatory)] + [string] + $Cron, + + [Parameter()] + # TZInfo::Timezone.all_identifiers + [ValidateSet("Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "Factory", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu")] + [string] + $CronTimezone = 'UTC', + + [Parameter()] + [ValidateSet($null, 'true', 'false')] + [string] + $Active, + + [Parameter()] + [string] + $SiteUrl + ) + + $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl + + if ([string]::IsNullOrWhiteSpace($Ref)) { + $Ref = $ProjectId -eq '.' -or $Ref -eq '.' ? $(Get-LocalGitContext).Branch : $Project.DefaultBranch + } + + $Body = @{ + ref = $Ref + description = $Description + cron = $Cron + cron_timezone = $CronTimezone + } + if ($Active) { + $Body.active = $Active + } + + if ($PSCmdlet.ShouldProcess("$($Project.PathWithNamespace)", "create new schedule $($Body | ConvertTo-Json)")) { + + $GitlabApiArguments = @{ + HttpMethod = 'POST' + Path = "projects/$($Project.Id)/pipeline_schedules" + Body = $Body + SiteUrl = $SiteUrl + } + $Wrapper = Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf | New-WrapperObject 'Gitlab.PipelineSchedule' + $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'ProjectId' -Value $ProjectId + $Wrapper + } +} + +function Update-GitlabPipelineSchedule { + [CmdletBinding(SupportsShouldProcess)] + param ( + [Parameter(ValueFromPipelineByPropertyName)] + [string] + $ProjectId = '.', + + [Parameter(Mandatory, ValueFromPipelineByPropertyName)] + [Alias('Id')] + [int] + $PipelineScheduleId, + + [Parameter()] + [string] + $Description, + + [Parameter()] + [Alias("Branch")] + [string] + $Ref, + + [Parameter()] + [string] + $Cron, + + [Parameter()] + [string] + # TZInfo::Timezone.all_identifiers + [ValidateSet("Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "Factory", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu")] + $CronTimezone, + + [Parameter()] + [ValidateSet($null, 'false', 'true')] + [string] + $Active, + + [Parameter()] + [string] + $NewOwner, + + [Parameter()] + [string] + $SiteUrl + ) + + $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl + + # https://docs.gitlab.com/ee/api/pipeline_schedules.html#edit-a-pipeline-schedule + $GitlabApiArguments = @{ + HttpMethod = 'PUT' + Path = "projects/$($Project.Id)/pipeline_schedules/$PipelineScheduleId" + Body = @{} + SiteUrl = $SiteUrl + } + + if ($Active) { + $GitlabApiArguments.Body.active = $Active + } + if ($Description) { + $GitlabApiArguments.Body.description = $Description + } + if ($Ref) { + $GitlabApiArguments.Body.ref = $Ref + } + if ($Cron) { + $GitlabApiArguments.Body.cron = $Cron + } + if ($CronTimezone) { + $GitlabApiArguments.Body.cron_timezone = $CronTimezone + } + + if ($GitlabApiArguments.Body.Count -gt 0) { + if ($PSCmdlet.ShouldProcess("$($GitlabApiArguments.Path)", "update schedule $($GitlabApiArguments.Body | ConvertTo-Json)")) { + Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf | New-WrapperObject 'Gitlab.PipelineSchedule' + } + } + + if ($NewOwner) { + if ($PSCmdlet.ShouldProcess("$($Project.PathWithNamespace)", "transfer ownership of pipeline schedule $PipelineScheduleId to $NewOwner")) { + $Owner = Get-GitlabUser $NewOwner + Start-GitlabUserImpersonation -UserId $Owner.Id -SiteUrl $SiteUrl + # https://docs.gitlab.com/ee/api/pipeline_schedules.html#take-ownership-of-a-pipeline-schedule + Invoke-GitlabApi POST "projects/$($Project.Id)/pipeline_schedules/$PipelineScheduleId/take_ownership" -SiteUrl $SiteUrl | Out-Null + Write-Host "Ownership of pipeline schedule $PipelineScheduleId transferred to $($Owner.Username)" + Stop-GitlabUserImpersonation -SiteUrl $SiteUrl + } + } +} + +function Enable-GitlabPipelineSchedule { + [CmdletBinding(SupportsShouldProcess)] + param ( + [Parameter(ValueFromPipelineByPropertyName)] + [string] + $ProjectId = '.', + + [Parameter(Mandatory, ValueFromPipelineByPropertyName)] + [Alias('Id')] + [int] + $PipelineScheduleId, + + [Parameter()] + [string] + $SiteUrl + ) + + $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl + + if ($PSCmdlet.ShouldProcess("$($Project.PathWithNamespace)", "enable pipeline schedule $PipelineScheduleId")) { + Update-GitlabPipelineSchedule -ProjectId $ProjectId -PipelineScheduleId $PipelineScheduleId -Active true -SiteUrl $SiteUrl + } +} + +function Disable-GitlabPipelineSchedule { + [CmdletBinding(SupportsShouldProcess)] + param ( + [Parameter(ValueFromPipelineByPropertyName)] + [string] + $ProjectId = '.', + + [Parameter(Mandatory, ValueFromPipelineByPropertyName)] + [Alias('Id')] + [int] + $PipelineScheduleId, + + [Parameter()] + [string] + $SiteUrl + ) + + $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl + + if ($PSCmdlet.ShouldProcess("$($Project.PathWithNamespace)", "disable pipeline schedule $PipelineScheduleId")) { + Update-GitlabPipelineSchedule -ProjectId $ProjectId -PipelineScheduleId $PipelineScheduleId -Active false -SiteUrl $SiteUrl + } +} + +# https://docs.gitlab.com/ee/api/pipeline_schedules.html#delete-a-pipeline-schedule +function Remove-GitlabPipelineSchedule { + param ( + [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] + [string] + $ProjectId = '.', + + [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] + [Alias('Id')] + [int] + $PipelineScheduleId, + + [Parameter(Mandatory=$false)] + [string] + $SiteUrl, + + [switch] + [Parameter(Mandatory=$false)] + $WhatIf + ) + + $Project = Get-GitlabProject -SiteUrl $SiteUrl + + $GitlabApiArguments = @{ + HttpMethod = 'DELETE' + Path = "projects/$($Project.Id)/pipeline_schedules/$PipelineScheduleId" + SiteUrl = $SiteUrl + } + + Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf +} + +#https://docs.gitlab.com/ee/api/pipeline_schedules.html#pipeline-schedule-variables +# This behavior isn't part of the api, but a nested structure on getting a PipelineSchedule itself JUST by Id +function Get-GitlabPipelineScheduleVariable { + param ( + [Parameter(Mandatory=$false)] + [string] + $ProjectId="." , + + [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] + [int] + $PipelineScheduleId, + + [Parameter(Mandatory=$false)] + $Key, + + [Parameter(Mandatory=$false)] + [string] + $SiteUrl, + + [switch] + [Parameter(Mandatory=$false)] + $WhatIf + ) + + $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl + $PipelineSchedule = Get-GitlabPipelineSchedule -ProjectId $Project.Id -PipelineScheduleId $PipelineScheduleId + + $Wrapper = $PipelineSchedule.Variables | New-WrapperObject "Gitlab.PipelineScheduleVariable" + $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'ProjectId' -Value $Project.Id + $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'PipelineScheduleId' -Value $PipelineSchedule.Id + + if($Key) { + $Wrapper = $Wrapper | Where-Object { $_.Key -eq $Key } + } + + $Wrapper +} + +function New-GitlabPipelineScheduleVariable { + param ( + [Parameter(Mandatory=$false)] + [string] + $ProjectId="." , + + [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] + [int] + $PipelineScheduleId, + + [Parameter(Mandatory=$true)] + [ValidatePattern("[A-Za-z0-9_]")] + [string] + $Key, + + [Parameter(Mandatory=$true)] + [string] + $Value, + + [Parameter(Mandatory=$false)] + [ValidateSet("env_var","file")] + [string] + $VariableType="env_var", + + [Parameter(Mandatory=$false)] + [string] + $SiteUrl, + + [switch] + [Parameter(Mandatory=$false)] + $WhatIf + ) + + $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl + $PipelineSchedule = Get-GitlabPipelineSchedule -ProjectId $Project.Id -PipelineScheduleId $PipelineScheduleId + + $Body = @{ + "key" = $Key + "value" = $Value + "variable_type" = $VariableType + } + + $GitlabApiArguments = @{ + HttpMethod = "POST" + Path = "projects/$($Project.Id)/pipeline_schedules/$($PipelineSchedule.Id)/variables" + SiteUrl = $SiteUrl + Body = $Body + } + + Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf | New-WrapperObject "Gitlab.PipelineScheduleVariable" + $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'ProjectId' -Value $Project.Id + $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'PipelineScheduleId' -Value $PipelineSchedule.Id +} + +function Update-GitlabPipelineScheduleVariable { + param ( + [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] + [string] + $ProjectId="." , + + [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] + [int] + $PipelineScheduleId, + + [Parameter(Mandatory=$true)] + [ValidateLength(255)] + [ValidatePattern("[A-Za-z0-9_]")] + [string] + $Key, + + [Parameter(Mandatory=$true)] + [string] + $Value, + + [Parameter(Mandatory=$false)] + [ValidateSet("env_var","file")] + [string] + $VariableType="env_var", + + [Parameter(Mandatory=$false)] + [string] + $SiteUrl, + + [switch] + [Parameter(Mandatory=$false)] + $WhatIf + ) + + $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl + $PipelineSchedule = Get-GitlabPipelineSchedule -ProjectId $ProjectId -PipelineScheduleId $PipelineScheduleId + + $Body = @{ + "key" = $Key + "value" = $Value + "variable_type" = $VariableType + } + + $GitlabApiArguments = @{ + HttpMethod = "PUT" + Path = "projects/$($Project.Id)/pipeline_schedules/$($PipelineSchedule.Id)/variables/$($Key)" + SiteUrl = $SiteUrl + Body = $Body + } + + Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf | New-WrapperObject "Gitlab.PipelineScheduleVariable" + $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'ProjectId' -Value $Project.Id + $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'PipelineScheduleId' -Value $PipelineSchedule.Id +} + +function Remove-GitlabPipelineScheduleVariable { + param ( + [Parameter(Mandatory=$false)] + [string] + $ProjectId="." , + + [Parameter(Mandatory=$true)] + [int] + $PipelineScheduleId, + + [Parameter(Mandatory=$true)] + [string] + $Key + ) + + $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl + $PipelineSchedule = Get-GitlabPipelineSchedule -ProjectId $ProjectId -PipelineScheduleId $PipelineScheduleId + + + $GitlabApiArguments = @{ + HttpMethod = "DELETE" + Path = "projects/$($Project.Id)/pipeline_schedules/$($PipelineSchedule.Id)/$($Key)" + SiteUrl = $SiteUrl + } + + Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf | New-WrapperObject "Gitlab.PipelineScheduleVariable" + $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'ProjectId' -Value $Project.Id + $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'PipelineScheduleId' -Value $PipelineSchedule.Id +} + +# https://docs.gitlab.com/ee/api/pipeline_schedules.html#run-a-scheduled-pipeline-immediately +function New-GitlabScheduledPipeline { + param ( + [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] + [string] + $ProjectId = '.', + + [Parameter(Position=0, Mandatory=$true, ValueFromPipelineByPropertyName=$true)] + [int] + $PipelineScheduleId, + + [Parameter(Mandatory=$false)] + [string] + $SiteUrl, + + [switch] + [Parameter(Mandatory=$false)] + $WhatIf + ) + + $Project = Get-GitlabProject -SiteUrl $SiteUrl + + $GitlabApiArguments = @{ + HttpMethod = 'POST' + Path = "projects/$($Project.Id)/pipeline_schedules/$PipelineScheduleId/play" + SiteUrl = $SiteUrl + } + + Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf | Select-Object -ExpandProperty 'message' +} diff --git a/src/GitlabCli/Pipelines.psm1 b/src/GitlabCli/Pipelines.psm1 index e2bc930..51a3f81 100644 --- a/src/GitlabCli/Pipelines.psm1 +++ b/src/GitlabCli/Pipelines.psm1 @@ -223,497 +223,6 @@ function Get-GitlabPipelineVariable { } } -function Get-GitlabPipelineSchedule { - - [CmdletBinding(DefaultParameterSetName='ByProjectId')] - [Alias('schedule')] - [Alias('schedules')] - param ( - [Parameter(ParameterSetName='ByProjectId', ValueFromPipelineByPropertyName)] - [Parameter(ParameterSetName='ByPipelineScheduleId')] - [string] - $ProjectId = '.', - - [Parameter(ParameterSetName='ByPipelineScheduleId', Mandatory)] - [Alias('Id')] - [int] - $PipelineScheduleId, - - [Parameter(ParameterSetName='ByProjectId')] - [string] - [ValidateSet('active', 'inactive')] - $Scope, - - [Parameter(ParameterSetName='ByProjectId', ValueFromPipelineByPropertyName)] - [switch] - $IncludeVariables, - - [Parameter()] - [string] - $SiteUrl - ) - - $Project = Get-GitlabProject -ProjectId $ProjectId - - $GitlabApiArguments = @{ - HttpMethod = 'GET' - # https://docs.gitlab.com/ee/api/pipeline_schedules.html#get-all-pipeline-schedules - Path = "projects/$($Project.Id)/pipeline_schedules" - Query = @{} - SiteUrl = $SiteUrl - } - - switch ($PSCmdlet.ParameterSetName) { - ByPipelineScheduleId { - $GitlabApiArguments.Path += "/$PipelineScheduleId" - } - ByProjectId { - if($Scope) { - $GitlabApiArguments.Query.scope = $Scope - } - } - default { throw "Parameterset $($PSCmdlet.ParameterSetName) is not implemented"} - } - - $Wrapper = Invoke-GitlabApi @GitlabApiArguments | New-WrapperObject 'Gitlab.PipelineSchedule' - $Wrapper | Add-Member -NotePropertyMembers @{ Project = $Project } - - if ($IncludeVariables) { - # only returned by the single schedule API so have to fetch them individually - # (https://docs.gitlab.com/ee/api/pipeline_schedules.html#get-a-single-pipeline-schedule) - $Wrapper = $Wrapper | ForEach-Object { Get-GitlabPipelineSchedule -ProjectId $_.ProjectId -PipelineScheduleId $_.Id } - } - - $Wrapper | Sort-Object NextRunAtSortable -} - -# https://docs.gitlab.com/ee/api/pipeline_schedules.html#create-a-new-pipeline-schedule -function New-GitlabPipelineSchedule { - [CmdletBinding(SupportsShouldProcess)] - param ( - [Parameter(ValueFromPipelineByPropertyName)] - [string] - $ProjectId = '.', - - [Parameter(ValueFromPipelineByPropertyName)] - [Alias('Branch')] - [string] - $Ref, - - [Parameter(Mandatory)] - [string] - $Description, - - [Parameter(Mandatory)] - [string] - $Cron, - - [Parameter()] - # TZInfo::Timezone.all_identifiers - [ValidateSet("Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "Factory", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu")] - [string] - $CronTimezone = 'UTC', - - [Parameter()] - [ValidateSet($null, 'true', 'false')] - [string] - $Active, - - [Parameter()] - [string] - $SiteUrl - ) - - $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl - - if ([string]::IsNullOrWhiteSpace($Ref)) { - $Ref = $ProjectId -eq '.' -or $Ref -eq '.' ? $(Get-LocalGitContext).Branch : $Project.DefaultBranch - } - - $Body = @{ - ref = $Ref - description = $Description - cron = $Cron - cron_timezone = $CronTimezone - } - if ($Active) { - $Body.active = $Active - } - - if ($PSCmdlet.ShouldProcess("$($Project.PathWithNamespace)", "create new schedule $($Body | ConvertTo-Json)")) { - - $GitlabApiArguments = @{ - HttpMethod = 'POST' - Path = "projects/$($Project.Id)/pipeline_schedules" - Body = $Body - SiteUrl = $SiteUrl - } - $Wrapper = Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf | New-WrapperObject 'Gitlab.PipelineSchedule' - $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'ProjectId' -Value $ProjectId - $Wrapper - } -} - -# https://docs.gitlab.com/ee/api/pipeline_schedules.html#edit-a-pipeline-schedule -function Update-GitlabPipelineSchedule { - [CmdletBinding(SupportsShouldProcess)] - param ( - [Parameter(ValueFromPipelineByPropertyName)] - [string] - $ProjectId = '.', - - [Parameter(Mandatory, ValueFromPipelineByPropertyName)] - [Alias('Id')] - [int] - $PipelineScheduleId, - - [Parameter()] - [string] - $Description, - - [Parameter()] - [Alias("Branch")] - [string] - $Ref, - - [Parameter()] - [string] - $Cron, - - [Parameter()] - [string] - # TZInfo::Timezone.all_identifiers - [ValidateSet("Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "Factory", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu")] - $CronTimezone, - - [Parameter()] - [ValidateSet($null, 'false', 'true')] - [string] - $Active, - - [Parameter()] - [string] - $SiteUrl - ) - - $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl - - $GitlabApiArguments = @{ - HttpMethod = 'PUT' - Path = "projects/$($Project.Id)/pipeline_schedules/$PipelineScheduleId" - Body = @{} - SiteUrl = $SiteUrl - } - - if ($Active) { - $GitlabApiArguments.Body.active = $Active - } - if ($Description) { - $GitlabApiArguments.Body.description = $Description - } - if ($Ref) { - $GitlabApiArguments.Body.ref = $Ref - } - if ($Cron) { - $GitlabApiArguments.Body.cron = $Cron - } - if ($CronTimezone) { - $GitlabApiArguments.Body.cron_timezone = $CronTimezone - } - - if ($PSCmdlet.ShouldProcess("$($GitlabApiArguments.Path)", "update schedule $($GitlabApiArguments.Body | ConvertTo-Json)")) { - Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf | New-WrapperObject 'Gitlab.PipelineSchedule' - } -} - -function Enable-GitlabPipelineSchedule { - [CmdletBinding(SupportsShouldProcess)] - param ( - [Parameter(ValueFromPipelineByPropertyName)] - [string] - $ProjectId = '.', - - [Parameter(Mandatory, ValueFromPipelineByPropertyName)] - [Alias('Id')] - [int] - $PipelineScheduleId, - - [Parameter()] - [string] - $SiteUrl - ) - - $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl - - if ($PSCmdlet.ShouldProcess("$($Project.PathWithNamespace)", "enable pipeline schedule $PipelineScheduleId")) { - Update-GitlabPipelineSchedule -ProjectId $ProjectId -PipelineScheduleId $PipelineScheduleId -Active true -SiteUrl $SiteUrl - } -} - -function Disable-GitlabPipelineSchedule { - [CmdletBinding(SupportsShouldProcess)] - param ( - [Parameter(ValueFromPipelineByPropertyName)] - [string] - $ProjectId = '.', - - [Parameter(Mandatory, ValueFromPipelineByPropertyName)] - [Alias('Id')] - [int] - $PipelineScheduleId, - - [Parameter()] - [string] - $SiteUrl - ) - - $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl - - if ($PSCmdlet.ShouldProcess("$($Project.PathWithNamespace)", "disable pipeline schedule $PipelineScheduleId")) { - Update-GitlabPipelineSchedule -ProjectId $ProjectId -PipelineScheduleId $PipelineScheduleId -Active false -SiteUrl $SiteUrl - } -} - -# https://docs.gitlab.com/ee/api/pipeline_schedules.html#delete-a-pipeline-schedule -function Remove-GitlabPipelineSchedule { - param ( - [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] - [string] - $ProjectId = '.', - - [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] - [Alias('Id')] - [int] - $PipelineScheduleId, - - [Parameter(Mandatory=$false)] - [string] - $SiteUrl, - - [switch] - [Parameter(Mandatory=$false)] - $WhatIf - ) - - $Project = Get-GitlabProject -SiteUrl $SiteUrl - - $GitlabApiArguments = @{ - HttpMethod = 'DELETE' - Path = "projects/$($Project.Id)/pipeline_schedules/$PipelineScheduleId" - SiteUrl = $SiteUrl - } - - Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf -} - -#https://docs.gitlab.com/ee/api/pipeline_schedules.html#pipeline-schedule-variables -# This behavior isn't part of the api, but a nested structure on getting a PipelineSchedule itself JUST by Id -function Get-GitlabPipelineScheduleVariable { - param ( - [Parameter(Mandatory=$false)] - [string] - $ProjectId="." , - - [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] - [int] - $PipelineScheduleId, - - [Parameter(Mandatory=$false)] - $Key, - - [Parameter(Mandatory=$false)] - [string] - $SiteUrl, - - [switch] - [Parameter(Mandatory=$false)] - $WhatIf - ) - - $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl - $PipelineSchedule = Get-GitlabPipelineSchedule -ProjectId $Project.Id -PipelineScheduleId $PipelineScheduleId - - $Wrapper = $PipelineSchedule.Variables | New-WrapperObject "Gitlab.PipelineScheduleVariable" - $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'ProjectId' -Value $Project.Id - $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'PipelineScheduleId' -Value $PipelineSchedule.Id - - if($Key) { - $Wrapper = $Wrapper | Where-Object { $_.Key -eq $Key } - } - - $Wrapper -} - -function New-GitlabPipelineScheduleVariable { - param ( - [Parameter(Mandatory=$false)] - [string] - $ProjectId="." , - - [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] - [int] - $PipelineScheduleId, - - [Parameter(Mandatory=$true)] - [ValidatePattern("[A-Za-z0-9_]")] - [string] - $Key, - - [Parameter(Mandatory=$true)] - [string] - $Value, - - [Parameter(Mandatory=$false)] - [ValidateSet("env_var","file")] - [string] - $VariableType="env_var", - - [Parameter(Mandatory=$false)] - [string] - $SiteUrl, - - [switch] - [Parameter(Mandatory=$false)] - $WhatIf - ) - - $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl - $PipelineSchedule = Get-GitlabPipelineSchedule -ProjectId $Project.Id -PipelineScheduleId $PipelineScheduleId - - $Body = @{ - "key" = $Key - "value" = $Value - "variable_type" = $VariableType - } - - $GitlabApiArguments = @{ - HttpMethod = "POST" - Path = "projects/$($Project.Id)/pipeline_schedules/$($PipelineSchedule.Id)/variables" - SiteUrl = $SiteUrl - Body = $Body - } - - Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf | New-WrapperObject "Gitlab.PipelineScheduleVariable" - $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'ProjectId' -Value $Project.Id - $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'PipelineScheduleId' -Value $PipelineSchedule.Id -} - -function Update-GitlabPipelineScheduleVariable { - param ( - [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] - [string] - $ProjectId="." , - - [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] - [int] - $PipelineScheduleId, - - [Parameter(Mandatory=$true)] - [ValidateLength(255)] - [ValidatePattern("[A-Za-z0-9_]")] - [string] - $Key, - - [Parameter(Mandatory=$true)] - [string] - $Value, - - [Parameter(Mandatory=$false)] - [ValidateSet("env_var","file")] - [string] - $VariableType="env_var", - - [Parameter(Mandatory=$false)] - [string] - $SiteUrl, - - [switch] - [Parameter(Mandatory=$false)] - $WhatIf - ) - - $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl - $PipelineSchedule = Get-GitlabPipelineSchedule -ProjectId $ProjectId -PipelineScheduleId $PipelineScheduleId - - $Body = @{ - "key" = $Key - "value" = $Value - "variable_type" = $VariableType - } - - $GitlabApiArguments = @{ - HttpMethod = "PUT" - Path = "projects/$($Project.Id)/pipeline_schedules/$($PipelineSchedule.Id)/variables/$($Key)" - SiteUrl = $SiteUrl - Body = $Body - } - - Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf | New-WrapperObject "Gitlab.PipelineScheduleVariable" - $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'ProjectId' -Value $Project.Id - $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'PipelineScheduleId' -Value $PipelineSchedule.Id -} - -function Remove-GitlabPipelineScheduleVariable { - param ( - [Parameter(Mandatory=$false)] - [string] - $ProjectId="." , - - [Parameter(Mandatory=$true)] - [int] - $PipelineScheduleId, - - [Parameter(Mandatory=$true)] - [string] - $Key - ) - - $Project = Get-GitlabProject $ProjectId -SiteUrl $SiteUrl - $PipelineSchedule = Get-GitlabPipelineSchedule -ProjectId $ProjectId -PipelineScheduleId $PipelineScheduleId - - - $GitlabApiArguments = @{ - HttpMethod = "DELETE" - Path = "projects/$($Project.Id)/pipeline_schedules/$($PipelineSchedule.Id)/$($Key)" - SiteUrl = $SiteUrl - } - - Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf | New-WrapperObject "Gitlab.PipelineScheduleVariable" - $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'ProjectId' -Value $Project.Id - $Wrapper | Add-Member -MemberType 'NoteProperty' -Name 'PipelineScheduleId' -Value $PipelineSchedule.Id -} - -# https://docs.gitlab.com/ee/api/pipeline_schedules.html#run-a-scheduled-pipeline-immediately -function New-GitlabScheduledPipeline { - param ( - [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] - [string] - $ProjectId = '.', - - [Parameter(Position=0, Mandatory=$true, ValueFromPipelineByPropertyName=$true)] - [int] - $PipelineScheduleId, - - [Parameter(Mandatory=$false)] - [string] - $SiteUrl, - - [switch] - [Parameter(Mandatory=$false)] - $WhatIf - ) - - $Project = Get-GitlabProject -SiteUrl $SiteUrl - - $GitlabApiArguments = @{ - HttpMethod = 'POST' - Path = "projects/$($Project.Id)/pipeline_schedules/$PipelineScheduleId/play" - SiteUrl = $SiteUrl - } - - Invoke-GitlabApi @GitlabApiArguments -WhatIf:$WhatIf | Select-Object -ExpandProperty 'message' -} - # https://docs.gitlab.com/ee/api/jobs.html#list-pipeline-bridges function Get-GitlabPipelineBridge { [CmdletBinding()] diff --git a/src/GitlabCli/Users.psm1 b/src/GitlabCli/Users.psm1 index 34664b4..cd5a999 100644 --- a/src/GitlabCli/Users.psm1 +++ b/src/GitlabCli/Users.psm1 @@ -265,3 +265,74 @@ function Get-GitlabCurrentUser { Get-GitlabUser -Me -SiteUrl $SiteUrl } + +function Start-GitlabUserImpersonation { + [CmdletBinding(SupportsShouldProcess)] + param ( + [Parameter(Position=0, Mandatory, ValueFromPipelineByPropertyName)] + [Alias('Id')] + [Alias('Username')] + [Alias('EmailAddress')] + [string] + $UserId, + + [Parameter()] + [string] + $SiteUrl + ) + $User = Get-GitlabUser $UserId + + # https://docs.gitlab.com/ee/api/users.html#create-an-impersonation-token + $Parameters = @{ + Method = 'POST' + Path = "users/$($User.Id)/impersonation_tokens" + Body = @{ + name = "pwsh-gitlab temporary impersonation token $($User.Username)" + expires_at = (Get-Date).AddDays(1).ToString('yyyy-MM-dd') + scopes = @('api', 'read_user') + } + SiteUrl = $SiteUrl + } + if ($PSCmdlet.ShouldProcess("$($User.Username)", "start impersonation")) { + + if ($global:GitlabUserImpersonationSession) { + Write-Error "Impersonation session already started by $($global:GitlabUserImpersonationSession.StartedBy). Call 'Stop-GitlabUserImpersonation' before attempting a new session." + } + + $Result = Invoke-GitlabApi @Parameters + $global:GitlabUserImpersonationSession = @{ + Id = $Result.id + UserId = $Result.user_id + Username = $User.Username + Token = $Result.token + } + } +} + +function Stop-GitlabUserImpersonation { + [CmdletBinding(SupportsShouldProcess)] + param ( + [Parameter()] + [string] + $SiteUrl + ) + + if ($PSCmdlet.ShouldProcess("Impersonation session for $($global:GitlabUserImpersonationSession.Username)", "stop")) { + if ($global:GitlabUserImpersonationSession) { + # https://docs.gitlab.com/ee/api/users.html#revoke-an-impersonation-token + $Parameters = @{ + Method = 'DELETE' + Path = "users/$($global:GitlabUserImpersonationSession.UserId)/impersonation_tokens/$($global:GitlabUserImpersonationSession.Id)" + SiteUrl = $SiteUrl + } + # NOTE: important that we clear first as the revoke API requires admin + $global:GitlabUserImpersonationSession = $null + if (Invoke-GitlabApi @Parameters) { + Write-Host "Impersonation session ($($global:GitlabUserImpersonationSession.Username)) stopped" + } + } + else { + Write-Warning "No impersonation session started. Call 'Start-GitlabUserImpersonation' to start one." + } + } +} diff --git a/src/GitlabCli/Utilities.psm1 b/src/GitlabCli/Utilities.psm1 index 4ec5894..482e124 100644 --- a/src/GitlabCli/Utilities.psm1 +++ b/src/GitlabCli/Utilities.psm1 @@ -108,7 +108,10 @@ function Invoke-GitlabApi { $Headers = @{ Accept = 'application/json' } - if (-not $AccessToken) { + if ($global:GitlabUserImpersonationSession) { + Write-Verbose "Impersonating API call as '$($global:GitlabUserImpersonationSession.Username)'..." + $AccessToken = $global:GitlabUserImpersonationSession.Token + } elseif (-not $AccessToken) { $AccessToken = $Site.AccessToken } if ($AccessToken) { @@ -142,7 +145,7 @@ function Invoke-GitlabApi { } $Proxy = $ProxyUrl ?? $Site.ProxyUrl if (-not [string]::IsNullOrWhiteSpace($Proxy)) { - Write-Verbose "Using proxy $Proxy" + Write-Verbose "Using proxy $Proxy..." } if($MaxPages -gt 1) { $RestMethodParams.FollowRelLink = $true @@ -159,8 +162,9 @@ function Invoke-GitlabApi { Write-Host "WhatIf: $HostOutput" } else { - Write-Verbose "$HostOutput" + Write-Verbose "Request: $HostOutput" $Result = Invoke-RestMethod @RestMethodParams + Write-Verbose "Response: $($Result | ConvertTo-Json)" if($MaxPages -gt 1) { # Unwrap pagination container $Result | ForEach-Object { diff --git a/src/GitlabCli/_Init.ps1 b/src/GitlabCli/_Init.ps1 index e709676..cdfc967 100644 --- a/src/GitlabCli/_Init.ps1 +++ b/src/GitlabCli/_Init.ps1 @@ -59,3 +59,4 @@ $global:GitlabIdentityPropertyNameExemptions=@{ 'Gitlab.Variable' = '' } $global:GitlabJobLogSections = New-Object 'Collections.Generic.Stack[string]' +$global:GitlabUserImpersonationSession = $null