On this page

    Add-Label

    SYNOPSIS

    Add a new global label to an existing Confluence page.

    SYNTAX

    Add-ConfluenceLabel -ApiUri <Uri> -Credential <PSCredential> [[-PageID] <Int32[]>] -Label <Object> [-WhatIf] [-Confirm]

    DESCRIPTION

    Assign labels (one or more) to Confluence pages (one or more).

    If the label did not exist previously, it will be created. Preexisting labels are not affected.

    EXAMPLES

    ————————– EXAMPLE 1 ————————–

    Add-ConfluenceLabel -PageID 123456 -Label alpha -Verbose

    Apply the label alpha to the wiki page with ID 123456. -Verbose output provides extra technical details, if interested.

    ————————– EXAMPLE 2 ————————–

    Get-ConfluencePage -SpaceKey SRV | Add-ConfluenceLabel -Label servers -WhatIf

    Simulates applying the label “servers” to all pages in the space with key SRV. -WhatIf provides PageIDs of pages that would have been affected.

    ————————– EXAMPLE 3 ————————–

    Get-ConfluencePage -SpaceKey DEMO | Add-ConfluenceLabel -Label abc -Confirm

    Applies the label “abc” to all pages in the space with key DEMO. -Confirm prompts Yes/No for each page that would be affected.

    PARAMETERS

    -ApiUri

    The URi of the API interface. Value can be set persistently with Set-Info.

    Type: Uri
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

    -Credential

    Confluence’s credentials for authentication. Value can be set persistently with Set-ConfluenceInfo.

    Type: PSCredential
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

    -Certificate

    Certificate for authentication.

    Type: X509Certificate
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

    -PageID

    The ID of the page to which apply the label to. Accepts multiple IDs, including via pipeline input.

    Type: Int32[]
Parameter Sets: (All)
Aliases: ID

Required: False
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

    -Label

    One or more labels to be added. Currently only supports labels of prefix “global”.

    Type: Object
Parameter Sets: (All)
Aliases: Labels

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

    -WhatIf

    Shows what would happen if the cmdlet runs. The cmdlet is not run.

    Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

    -Confirm

    Prompts you for confirmation before running the cmdlet.

    Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

    INPUTS

    OUTPUTS

    ConfluencePS.ContentLabelSet

    NOTES

    https://github.com/AtlassianPS/ConfluencePS