1
1
# Copyright (c) Microsoft Corporation. All rights reserved.
2
2
# Licensed under the MIT License.
3
3
4
- function Get-GitHubRelease
4
+ filter Get-GitHubRelease
5
5
{
6
6
<#
7
7
. SYNOPSIS
@@ -26,7 +26,7 @@ function Get-GitHubRelease
26
26
them individually.
27
27
28
28
. PARAMETER Release
29
- Specific releaseId of a release.
29
+ Specific Release ID of a release.
30
30
This is an optional parameter which can limit the results to a single release.
31
31
32
32
. PARAMETER Latest
@@ -127,9 +127,11 @@ function Get-GitHubRelease
127
127
128
128
[Parameter (
129
129
Mandatory ,
130
+ ValueFromPipelineByPropertyName ,
130
131
ParameterSetName = ' Elements-ReleaseId' )]
131
132
[Parameter (
132
133
Mandatory ,
134
+ ValueFromPipelineByPropertyName ,
133
135
ParameterSetName = ' Uri-ReleaseId' )]
134
136
[Alias (' ReleaseId' )]
135
137
[int64 ] $Release ,
@@ -199,7 +201,7 @@ function Get-GitHubRelease
199
201
' AccessToken' = $AccessToken
200
202
' TelemetryEventName' = $MyInvocation.MyCommand.Name
201
203
' TelemetryProperties' = $telemetryProperties
202
- ' NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue - BoundParameters $PSBoundParameters - Name NoStatus - ConfigValueName DefaultNoStatus)
204
+ ' NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue - Name NoStatus - ConfigValueName DefaultNoStatus)
203
205
}
204
206
205
207
$multipleResult = Invoke-GHRestMethodMultipleResult @params
@@ -213,7 +215,7 @@ function Get-GitHubRelease
213
215
return $multipleResult
214
216
}
215
217
216
- function New-GitHubRelease
218
+ filter New-GitHubRelease
217
219
{
218
220
<#
219
221
. SYNOPSIS
@@ -291,7 +293,7 @@ function New-GitHubRelease
291
293
Mandatory ,
292
294
ValueFromPipelineByPropertyName ,
293
295
ParameterSetName = ' Uri' )]
294
- [Alias (' html_url ' )]
296
+ [Alias (' RepositoryUrl ' )]
295
297
[string ] $Uri ,
296
298
297
299
[Parameter (Mandatory )]
@@ -357,7 +359,7 @@ function New-GitHubRelease
357
359
return $result
358
360
}
359
361
360
- function Set-GitHubRelease
362
+ filter Set-GitHubRelease
361
363
{
362
364
<#
363
365
. SYNOPSIS
@@ -435,7 +437,7 @@ function Set-GitHubRelease
435
437
Mandatory ,
436
438
ValueFromPipelineByPropertyName ,
437
439
ParameterSetName = ' Uri' )]
438
- [Alias (' html_url ' )]
440
+ [Alias (' RepositoryUrl ' )]
439
441
[string ] $Uri ,
440
442
441
443
[Parameter (
@@ -505,7 +507,7 @@ function Set-GitHubRelease
505
507
return $result
506
508
}
507
509
508
- function Remove-GitHubRelease
510
+ filter Remove-GitHubRelease
509
511
{
510
512
<#
511
513
. SYNOPSIS
@@ -570,7 +572,7 @@ function Remove-GitHubRelease
570
572
Mandatory ,
571
573
ValueFromPipelineByPropertyName ,
572
574
ParameterSetName = ' Uri' )]
573
- [Alias (' html_url ' )]
575
+ [Alias (' ReositoryUrl ' )]
574
576
[string ] $Uri ,
575
577
576
578
[Parameter (
@@ -611,7 +613,7 @@ function Remove-GitHubRelease
611
613
}
612
614
}
613
615
614
- function Get-GitHubReleaseAsset
616
+ filter Get-GitHubReleaseAsset
615
617
{
616
618
<#
617
619
. SYNOPSIS
@@ -635,6 +637,9 @@ function Get-GitHubReleaseAsset
635
637
The OwnerName and RepositoryName will be extracted from here instead of needing to provide
636
638
them individually.
637
639
640
+ . PARAMETER Release
641
+ The ID of a specific release to see the assets for.
642
+
638
643
. PARAMETER Asset
639
644
The ID of the specific asset to download.
640
645
@@ -655,10 +660,15 @@ function Get-GitHubReleaseAsset
655
660
If not supplied here, the DefaultNoStatus configuration property value will be used.
656
661
657
662
. EXAMPLE
658
- Remove-GitHubRelease -OwnerName microsoft -RepositoryName PowerShellForGitHub -Release 1234567890
663
+ Get-GitHubReleaseAsset -OwnerName microsoft -RepositoryName PowerShellForGitHub -Release 1234567890
659
664
660
- . NOTES
661
- Requires push access to the repository.
665
+ Gets a list of all the assets associated with this release
666
+
667
+ . EXAMPLE
668
+ Get-GitHubReleaseAsset -OwnerName microsoft -RepositoryName PowerShellForGitHub -Asset 1234567890 -Path 'c:\users\PowerShellForGitHub\downloads\asset.zip' -Force
669
+
670
+ Downloads the asset 1234567890 to 'c:\users\PowerShellForGitHub\downloads\asset.zip' and
671
+ overwrites the file that may already be there.
662
672
#>
663
673
[CmdletBinding (
664
674
SupportsShouldProcess ,
@@ -678,35 +688,47 @@ function Get-GitHubReleaseAsset
678
688
679
689
[Parameter (
680
690
Mandatory ,
691
+ ValueFromPipelineByPropertyName ,
681
692
ParameterSetName = ' Uri-Info' )]
682
693
[Parameter (
683
694
Mandatory ,
695
+ ValueFromPipelineByPropertyName ,
684
696
ParameterSetName = ' Uri-Download' )]
685
697
[Parameter (
686
698
Mandatory ,
699
+ ValueFromPipelineByPropertyName ,
687
700
ParameterSetName = ' Uri-List' )]
701
+ [Alias (' RepositoryUrl' )]
688
702
[string ] $Uri ,
689
703
690
704
[Parameter (
691
705
Mandatory ,
706
+ ValueFromPipelineByPropertyName ,
692
707
ParameterSetName = ' Elements-List' )]
693
708
[Parameter (
694
709
Mandatory ,
710
+ ValueFromPipelineByPropertyName ,
695
711
ParameterSetName = ' Uri-List' )]
712
+ [Alias (' ReleaseId' )]
696
713
[int64 ] $Release ,
697
714
698
715
[Parameter (
699
716
Mandatory ,
717
+ ValueFromPipelineByPropertyName ,
700
718
ParameterSetName = ' Elements-Info' )]
701
719
[Parameter (
702
720
Mandatory ,
721
+ ValueFromPipelineByPropertyName ,
703
722
ParameterSetName = ' Elements-Download' )]
704
723
[Parameter (
705
724
Mandatory ,
725
+ ValueFromPipelineByPropertyName ,
706
726
ParameterSetName = ' Uri-Info' )]
707
727
[Parameter (
708
728
Mandatory ,
729
+ ValueFromPipelineByPropertyName ,
709
730
ParameterSetName = ' Uri-Download' )]
731
+ [Alias (' AssetId' )]
710
732
[int64 ] $Asset ,
711
733
712
734
[Parameter (
@@ -786,7 +808,7 @@ function Get-GitHubReleaseAsset
786
808
}
787
809
}
788
810
789
- function New-GitHubReleaseAsset
811
+ filter New-GitHubReleaseAsset
790
812
{
791
813
<#
792
814
. SYNOPSIS
@@ -838,7 +860,7 @@ function New-GitHubReleaseAsset
838
860
If not supplied here, the DefaultNoStatus configuration property value will be used.
839
861
840
862
. EXAMPLE
841
- New-GitHubRelease -OwnerName microsoft -RepositoryName PowerShellForGitHub -TagName 0.12.0
863
+ New-GitHubReleaseAsset -OwnerName microsoft -RepositoryName PowerShellForGitHub -TagName 0.12.0
842
864
843
865
. NOTES
844
866
GitHub renames asset filenames that have special characters, non-alphanumeric characters,
@@ -861,15 +883,20 @@ function New-GitHubReleaseAsset
861
883
862
884
[Parameter (
863
885
Mandatory ,
886
+ ValueFromPipelineByPropertyName ,
864
887
ParameterSetName = ' Uri' )]
888
+ [Alias (' RepositoryUrl' )]
865
889
[string ] $Uri ,
866
890
867
891
[Parameter (
868
892
Mandatory ,
893
+ ValueFromPipelineByPropertyName ,
869
894
ParameterSetName = ' Elements' )]
870
895
[Parameter (
871
896
Mandatory ,
897
+ ValueFromPipelineByPropertyName ,
872
898
ParameterSetName = ' Uri' )]
899
+ [Alias (' ReleaseId' )]
873
900
[int64 ] $Release ,
874
901
875
902
[Parameter (
@@ -942,7 +969,7 @@ function New-GitHubReleaseAsset
942
969
return Invoke-GHRestMethod @params
943
970
}
944
971
945
- function Set-GitHubReleaseAsset
972
+ filter Set-GitHubReleaseAsset
946
973
{
947
974
<#
948
975
. SYNOPSIS
@@ -973,7 +1000,7 @@ function Set-GitHubReleaseAsset
973
1000
The new filename of the asset.
974
1001
975
1002
. PARAMETER Label
976
- An alternate short description o fthe asset. Used in place of the filename.
1003
+ An alternate short description of the asset. Used in place of the filename.
977
1004
978
1005
. PARAMETER AccessToken
979
1006
If provided, this will be used as the AccessToken for authentication with the
@@ -988,6 +1015,8 @@ function Set-GitHubReleaseAsset
988
1015
. EXAMPLE
989
1016
Set-GitHubReleaseAsset -OwnerName microsoft -RepositoryName PowerShellForGitHub -Asset 123456 -Name bar.zip
990
1017
1018
+ Renames the asset 123456 to be 'bar.zip'.
1019
+
991
1020
. NOTES
992
1021
Requires push access to the repository.
993
1022
#>
@@ -1005,10 +1034,15 @@ function Set-GitHubReleaseAsset
1005
1034
1006
1035
[Parameter (
1007
1036
Mandatory ,
1037
+ ValueFromPipelineByPropertyName ,
1008
1038
ParameterSetName = ' Uri' )]
1039
+ [Alias (' RepositoryUrl' )]
1009
1040
[string ] $Uri ,
1010
1041
1011
- [Parameter (Mandatory )]
1042
+ [Parameter (
1043
+ Mandatory ,
1044
+ ValueFromPipelineByPropertyName )]
1045
+ [Alias (' AssetId' )]
1012
1046
[int64 ] $Asset ,
1013
1047
1014
1048
[string ] $Name ,
@@ -1051,7 +1085,7 @@ function Set-GitHubReleaseAsset
1051
1085
return Invoke-GHRestMethod @params
1052
1086
}
1053
1087
1054
- function Remove-GitHubReleaseAsset
1088
+ filter Remove-GitHubReleaseAsset
1055
1089
{
1056
1090
<#
1057
1091
. SYNOPSIS
@@ -1089,10 +1123,10 @@ function Remove-GitHubReleaseAsset
1089
1123
If not supplied here, the DefaultNoStatus configuration property value will be used.
1090
1124
1091
1125
. EXAMPLE
1092
- Remove-GitHubReleaseAsset -OwnerName microsoft -RepositoryName PowerShellForGitHub -Release 1234567890
1126
+ Remove-GitHubReleaseAsset -OwnerName microsoft -RepositoryName PowerShellForGitHub -Asset 1234567890
1093
1127
1094
1128
. EXAMPLE
1095
- Remove-GitHubReleaseAsset -OwnerName microsoft -RepositoryName PowerShellForGitHub -Release 1234567890 -Confirm:$false
1129
+ Remove-GitHubReleaseAsset -OwnerName microsoft -RepositoryName PowerShellForGitHub -Asset 1234567890 -Confirm:$false
1096
1130
1097
1131
Will not prompt for confirmation, as -Confirm:$false was specified.
1098
1132
#>
@@ -1111,10 +1145,15 @@ function Remove-GitHubReleaseAsset
1111
1145
1112
1146
[Parameter (
1113
1147
Mandatory ,
1148
+ ValueFromPipelineByPropertyName ,
1114
1149
ParameterSetName = ' Uri' )]
1150
+ [Alias (' RepositoryUrl' )]
1115
1151
[string ] $Uri ,
1116
1152
1117
- [Parameter (Mandatory )]
1153
+ [Parameter (
1154
+ Mandatory ,
1155
+ ValueFromPipelineByPropertyName )]
1156
+ [Alias (' AssetId' )]
1118
1157
[int64 ] $Asset ,
1119
1158
1120
1159
[string ] $AccessToken ,
0 commit comments