Skip to content

Commit 4b7642c

Browse files
Merge branch 'dev' into feature/fix-5164-Timing-between-internal-API-in-Import-flow
2 parents 17adc1b + 59fd4a4 commit 4b7642c

File tree

11 files changed

+4355
-3671
lines changed

11 files changed

+4355
-3671
lines changed

CHANGELOG.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
2828
- Added support for `-ClearGroupId` parameter in `Set-PnPSite` and `Set-PnPTenantSite` cmdlets. [#5192](https://github.com/pnp/powershell/pull/5192)
2929
- Added support for batch restoring items from the recycle bin using `Restore-PnPRecycleBinItem -ListIds` [#4705](https://github.com/pnp/powershell/pull/4705)
3030
- Added optional `-ClearSubScopes` flag to `Set-PnPFolderPermission` and `Set-PnPListItemPermission` cmdlets to clear unique permissions on child items/folders when breaking permission inheritance [#5213](https://github.com/pnp/powershell/pull/5213)
31+
- Added `Get-PnPWebAlert` and `Remove-PnPWebAlert` cmdlets to get and remove SharePoint list alerts [#5218](https://github.com/pnp/powershell/pull/5218)
3132

3233
### Changed
3334
- Improved `Get-PnPTerm` cmdlet to show a better error message. [#4933](https://github.com/pnp/powershell/pull/4933)
@@ -68,6 +69,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
6869

6970
### Contributors
7071

72+
- Noel Tautges [NoelTautges]
7173
- Nishkalank Bezawada [NishkalankBezawada]
7274
- Irving [irvcov]
7375
- Koen Zomers [koenzomers]

dependencies.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
2-
"Updated": "20260204-031939",
2+
"Updated": "20260206-031956",
33
"PnPPowerShell": "4f087aa3e6641594c3c85b84df89c8f4e4f3cda0",
4-
"PnPFramework": "4374e92262e0e3f5aaa7b25da118e46d508b4a07",
5-
"PnPCore": "c5625cf7e0abfd59aa830a9a23bfc75647d5a30c"
4+
"PnPFramework": "2de50ab661a2c57c10f12113b08e1a28df36d3bd",
5+
"PnPCore": "dfcd000c68c8bfcb229971141ef85465b617c7e0"
66
}

documentation/Get-PnPWebAlert.md

Lines changed: 164 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,164 @@
1+
---
2+
Module Name: PnP.PowerShell
3+
schema: 2.0.0
4+
applicable: SharePoint Online
5+
online version: https://pnp.github.io/powershell/cmdlets/Get-PnPWebAlert.html
6+
external help file: PnP.PowerShell.dll-Help.xml
7+
title: Get-PnPWebAlert
8+
---
9+
10+
# Get-PnPWebAlert
11+
12+
## SYNOPSIS
13+
Returns alerts from the current web, optionally filtered by list and user.
14+
15+
## SYNTAX
16+
17+
### All
18+
```powershell
19+
Get-PnPWebAlert [-UserName <String>] [-UserId <Guid>] [-Connection <PnPConnection>]
20+
```
21+
22+
### By List Id
23+
```powershell
24+
Get-PnPWebAlert -ListId <Guid> [-UserName <String>] [-UserId <Guid>] [-Connection <PnPConnection>]
25+
```
26+
27+
### By List Url
28+
```powershell
29+
Get-PnPWebAlert -ListUrl <String> [-UserName <String>] [-UserId <Guid>] [-Connection <PnPConnection>]
30+
```
31+
32+
### By List Title
33+
```powershell
34+
Get-PnPWebAlert -ListTitle <String> [-UserName <String>] [-UserId <Guid>] [-Connection <PnPConnection>]
35+
```
36+
37+
## DESCRIPTION
38+
39+
Retrieves alerts from the current web using the REST API. You can optionally filter by list (ID, URL, or title) and by user. Specify either UserName or UserId, but not both.
40+
41+
## EXAMPLES
42+
43+
### EXAMPLE 1
44+
```powershell
45+
Get-PnPWebAlert
46+
```
47+
48+
Returns all alerts for the current web.
49+
50+
### EXAMPLE 2
51+
```powershell
52+
Get-PnPWebAlert -ListTitle "Documents"
53+
```
54+
55+
Returns alerts for the list with title "Documents".
56+
57+
### EXAMPLE 3
58+
```powershell
59+
Get-PnPWebAlert -ListUrl "Lists/Tasks" -UserName "alex.wilber@contoso.com"
60+
```
61+
62+
Returns alerts for the list at the specified URL and for the specified user.
63+
64+
### EXAMPLE 4
65+
```powershell
66+
Get-PnPWebAlert -UserId 12345678-90ab-cdef-1234-567890abcdef
67+
```
68+
69+
Returns alerts for the specified user ID.
70+
71+
## PARAMETERS
72+
73+
### -Connection
74+
Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
75+
76+
```yaml
77+
Type: PnPConnection
78+
Parameter Sets: (All)
79+
80+
Required: False
81+
Position: Named
82+
Default value: None
83+
Accept pipeline input: False
84+
Accept wildcard characters: False
85+
```
86+
87+
### -ListId
88+
The ID of the list to filter alerts by.
89+
90+
```yaml
91+
Type: Guid
92+
Parameter Sets: By List Id
93+
94+
Required: True
95+
Position: Named
96+
Default value: None
97+
Accept pipeline input: False
98+
Accept wildcard characters: False
99+
```
100+
101+
### -ListUrl
102+
The server-relative URL of the list to filter alerts by.
103+
104+
```yaml
105+
Type: String
106+
Parameter Sets: By List Url
107+
108+
Required: True
109+
Position: Named
110+
Default value: None
111+
Accept pipeline input: False
112+
Accept wildcard characters: False
113+
```
114+
115+
### -ListTitle
116+
The title of the list to filter alerts by.
117+
118+
```yaml
119+
Type: String
120+
Parameter Sets: By List Title
121+
122+
Required: True
123+
Position: Named
124+
Default value: None
125+
Accept pipeline input: False
126+
Accept wildcard characters: False
127+
```
128+
129+
### -UserId
130+
The user ID (GUID) to filter alerts by. Do not specify together with UserName.
131+
132+
```yaml
133+
Type: Guid
134+
Parameter Sets: (All)
135+
136+
Required: False
137+
Position: Named
138+
Default value: None
139+
Accept pipeline input: False
140+
Accept wildcard characters: False
141+
```
142+
143+
### -UserName
144+
The user principal name to filter alerts by. Do not specify together with UserId.
145+
146+
```yaml
147+
Type: String
148+
Parameter Sets: (All)
149+
150+
Required: False
151+
Position: Named
152+
Default value: None
153+
Accept pipeline input: False
154+
Accept wildcard characters: False
155+
```
156+
157+
## OUTPUTS
158+
159+
### Type
160+
PnP.PowerShell.Commands.Model.SharePoint.WebAlert
161+
162+
## RELATED LINKS
163+
164+
[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)
Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
Module Name: PnP.PowerShell
3+
title: Remove-PnPWebAlert
4+
schema: 2.0.0
5+
applicable: SharePoint Online
6+
external help file: PnP.PowerShell.dll-Help.xml
7+
online version: https://pnp.github.io/powershell/cmdlets/Remove-PnPWebAlert.html
8+
---
9+
10+
# Remove-PnPWebAlert
11+
12+
## SYNOPSIS
13+
Removes an alert from the current web.
14+
15+
## SYNTAX
16+
17+
```powershell
18+
Remove-PnPWebAlert -Identity <AlertPipeBind> [-Force] [-Connection <PnPConnection>]
19+
```
20+
21+
## DESCRIPTION
22+
23+
Removes the specified alert from the current web. By default, a confirmation prompt is shown unless Force is specified.
24+
25+
## EXAMPLES
26+
27+
### EXAMPLE 1
28+
```powershell
29+
Remove-PnPWebAlert -Identity 641ac67f-0ce0-4837-874a-743c8f8572a7
30+
```
31+
32+
Removes the alert with the specified ID.
33+
34+
### EXAMPLE 2
35+
```powershell
36+
Get-PnPWebAlert -ListTitle "Documents" | Remove-PnPWebAlert -Force
37+
```
38+
39+
Removes all alerts for the Documents list without prompting.
40+
41+
## PARAMETERS
42+
43+
### -Connection
44+
Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
45+
46+
```yaml
47+
Type: PnPConnection
48+
Parameter Sets: (All)
49+
50+
Required: False
51+
Position: Named
52+
Default value: None
53+
Accept pipeline input: False
54+
Accept wildcard characters: False
55+
```
56+
57+
### -Force
58+
Specifying the Force parameter will skip the confirmation question.
59+
60+
```yaml
61+
Type: SwitchParameter
62+
Parameter Sets: (All)
63+
64+
Required: False
65+
Position: Named
66+
Default value: None
67+
Accept pipeline input: False
68+
Accept wildcard characters: False
69+
```
70+
71+
### -Identity
72+
The alert id, or the actual alert object to remove.
73+
74+
```yaml
75+
Type: AlertPipeBind
76+
Parameter Sets: (All)
77+
78+
Required: True
79+
Position: 0
80+
Default value: None
81+
Accept pipeline input: True (ByValue)
82+
Accept wildcard characters: False
83+
```
84+
85+
## RELATED LINKS
86+
87+
[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)

0 commit comments

Comments
 (0)