Remove-SCSMAnnouncement
Remove-SCSMAnnouncement
Removes an announcement from Service Manager.
Syntax
Parameter Set: Default
Remove-SCSMAnnouncement [-Announcement] <EnterpriseManagementInstance[]> [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Remove-SCSMAnnouncement cmdlet removes an announcement from Service Manager.
Parameters
-Announcement<EnterpriseManagementInstance[]>
Specifies instances of announcements. To obtain an instance, use the Get-SCSMAnnouncement cmdlet.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Microsoft.EnterpriseManagement.Core.Cmdlets.Instances.EnterpriseManagementInstance
You can pipe an announcement to the Announcement parameter.
Outputs
The output type is the type of the objects that the cmdlet emits.
None.
This cmdlet does not generate any output.
Examples
Example 1: Remove announcements by using a title
This command removes all announcements with a title that matches the string labor day. The command uses the Get-SCSMAnnouncement cmdlet to get all announcement instances. The command passes the results to the Where-Object cmdlet, which passes on only those that have titles that match the specified string. The current cmdlet removes those announcements.
C:\PS>Get-SCSMAnnouncement | Where-Object { $_.title -match "labor day" } | Remove-SCSMAnnouncement