Set-GRRLabel.md

external help file	Module Name	online version	schema
PowerGRR-help.xml	PowerGRR	https://github.com/swisscom/PowerGRR/blob/master/docs/Set-GRRLabel.md	2.0.0

Set-GRRLabel

SYNOPSIS

Set a label on one or multiple clients.

SYNTAX

Set-GRRLabel [[-ComputerName] <String[]>] [[-Label] <String[]>] [[-Credential] <PSCredential>] [-ShowJSON]
 [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Set a label on one or multiple clients. The function has pipeline support.

EXAMPLES

Example 1

PS C:\> Set-GRRLabel -ComputerName host1, host2 -Label label1 -Credential $creds
PS C:\> "host1", "host2" | Set-GRRLabel -Label label1 -Credential $creds

Add the label "label1" to both hosts. It's possible to use pipeline to set the labels.

Example 2

PS C:\> Set-GRRLabel -ComputerName (Find-GRRClient -SearchString keyword -Credential $cred -OnlyNode) -Label test5,test3 -Credential $creds

Use the GRR search to find specific clients which should be labeled.

PARAMETERS

-ComputerName

Computernames which should be labeled.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

Required: False
Position: Benannt
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Credential

GRR credentials.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Label

Label to set for the clients.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
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: Benannt
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ShowJSON

Return plain JSON instead of converted JSON.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

System.String[]

OUTPUTS

System.Object

NOTES

RELATED LINKS