Skip to content

Remove-TriliumAttachment

SYNOPSIS

Removes a specific Trilium attachment by its ID.

SYNTAX

__AllParameterSets

Remove-TriliumAttachment [-AttachmentID] <string> [-SkipCertCheck] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIASES

None

DESCRIPTION

Deletes a Trilium attachment using the provided AttachmentID. Supports pipeline input for AttachmentID. Requires authentication via Connect-TriliumAuth.

EXAMPLES

EXAMPLE 1

Remove-TriliumAttachment -AttachmentID "evnnmvHTCgIn"

Removes the attachment with the specified ID.

EXAMPLE 2

"evnnmvHTCgIn", "abc123" | Remove-TriliumAttachment

Removes multiple attachments by piping their IDs to the function.

PARAMETERS

-AttachmentID

The ID of the attachment to remove. Accepts input from the pipeline.

Required?                    true
Position?                    0
Default value                None
Accept pipeline input?       true
Accept wildcard characters?  false

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SkipCertCheck

If specified, skips SSL certificate validation for the request.

Required?                    false
Position?                    Named
Default value                None
Accept pipeline input?       false
Accept wildcard characters?  false

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Tells PowerShell to run the command in a mode that only reports what would happen, but not actually let the command run or make changes.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

System.String

The attachment ID to remove. This parameter accepts pipeline input, allowing you to pipe attachment IDs directly to the cmdlet.

OUTPUTS

None

This cmdlet does not generate any output. It performs a deletion operation and returns nothing upon successful completion.

NOTES

  • Requires authentication via Connect-TriliumAuth.
  • This cmdlet supports pipeline input for batch operations on multiple attachments.
  • Supports -WhatIf parameter to preview what would be deleted without actually performing the deletion.
  • Supports -Confirm parameter to prompt for confirmation before deletion.
  • Use -SkipCertCheck parameter when working with self-signed certificates.
  • Author: P. Morris
  • Module: TriliumNext-Powershell-Module

TriliumNext PowerShell Module