Powershell: Set-NinjaTag

Thema

In diesem Artikel wird erläutert, wie Sie mit „Set-NinjaTag“ dem aktuellen Gerät ein bestimmtes System-Tag zuweisen können.

Wenn Sie das NinjaOne-PowerShell-Modul außerhalb eines Automatisierungsskripts verwenden, müssen Sie möglicherweise die Ausführungsrichtlinie von PowerShell anpassen. Weitere Informationen zu Ausführungsrichtlinien finden Sie in der Dokumentation von Microsoft: Informationen zu Ausführungsrichtlinien ( externer Link).

Umgebung

NinjaOne
Microsoft PowerShell

Beschreibung

Das Cmdlet „Set-NinjaTag“ weist dem aktuellen Gerät ein oder mehrere angegebene System-Tags zu. System-Tags sind vordefinierte Tags in der NinjaOne-Plattform, die zur Kategorisierung und Verwaltung von Geräten verwendet werden können. Das Cmdlet fügt dem aktuellen Gerät die angegebenen Tags hinzu, ohne bestehende Tags zu beeinflussen.

Dieses Cmdlet muss innerhalb eines Ninja-Automatisierungsskripts ausgeführt werden, um die zugewiesenen System-Tags zu ändern. Änderungen an der Tag-Zuweisung werden nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-Plattform übernommen, was in der Regel innerhalb weniger Minuten geschieht.

Syntax

Set-NinjaTag [-Name] <String[]> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Beispiele

Beispiel 1: Zuweisung über ein Automatisierungsskript

PS C:> Set-NinjaTag -Name „IIS“

Weist dem aktuellen Gerät das System-Tag „IIS“ zu.

Beispiel 2: Zuweisung über das aktive Terminal

PS C:> Set-NinjaTag -Name "IIS"
Set-NinjaTag: Der Zugriff auf Tags ist nur über ein Automatisierungsskript möglich
In Zeile: 1, Zeichen: 1
+ Set-NinjaTag -Name "IIS"
+ ~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : FromStdErr: (:) [Write-Error],
WriteErrorException
+ FullyQualifiedErrorId :
Microsoft.PowerShell.Commands.WriteErrorException,Set-NinjaTag

Tags können nur über ein Automatisierungsskript gesetzt werden, daher wird eine Fehlermeldung zurückgegeben, wenn versucht wird, das Cmdlet in einer aktiven Terminalsitzung auszuführen.

Parameter

-Confirm

Fordert Sie vor der Ausführung des Cmdlets zur Bestätigung auf.

Typ: SwitchParameter
Parametersätze: (Alle)
Aliase: cf
Erforderlich: False
Position: Benannt
Standardwert: Keiner
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False

-Force

Wenn „confirm“ nicht angegeben ist und das Cmdlet normalerweise eine Bestätigung anfordern würde, erzwingt dieser Parameter die Ausführung des Cmdlets ohne Bestätigungsaufforderung.

Typ: SwitchParameter
Parametersätze: (Alle)
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False

-Name

Geben Sie den Namen des System-Tags bzw. der System-Tags an, die dem aktuellen Gerät zugewiesen werden sollen.

Typ: String[]
Parametersätze: (Alle)
Aliase:
Erforderlich: True
Position: 0
Standardwert: Keine
Pipeline-Eingabe zulassen: True (ByValue)
Platzhalterzeichen zulassen: False

-WhatIf

Zeigt an, was passieren würde, wenn das Cmdlet ausgeführt würde. Das Cmdlet wird nicht ausgeführt.

Typ: SwitchParameter
Parametersätze: (Alle)
Aliase: wi
Erforderlich: Falsch
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: Falsch
Platzhalterzeichen zulassen: Falsch

Allgemeine Parameter

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen zu allgemeinen Parametern finden Sie im Microsoft-Dokument „about_CommonParameters“ ( externer Link).

Eingaben

System.String[]

Das Cmdlet akzeptiert ein Array von Zeichenfolgen, die die Namen der System-Tags darstellen, die dem aktuellen Gerät zugewiesen werden sollen.

Ausgaben

Keine

Dieses Cmdlet muss innerhalb eines Ninja-Automatisierungsskripts ausgeführt werden, um die zugewiesenen System-Tags zu ändern.
Änderungen an der Tag-Zuweisung werden nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-Plattform übernommen, was in der Regel innerhalb weniger Minuten geschieht.

Weitere Ressourcen

Weitere Informationen zum Asset-Management und zur Erstellung benutzerdefinierter Skripte finden Sie in den folgenden Ressourcen: