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 Skripts für Automatisierungen verwenden, müssen Sie möglicherweise die Ausführungsrichtlinie von PowerShell anpassen. Weitere Informationen zu Ausführungsrichtlinien finden Sie in der Dokumentation von Microsoft: Über 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 verändern. Änderungen an der Tag-Zuweisung werden nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-Plattform angewendet, 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 Zugang zu 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.Befehle.WriteErrorException,Set-NinjaTag

Tags können nur über ein Skript für die Automatisierung festgelegt werden, daher wird eine Fehlermeldung zurückgegeben, wenn versucht wird, das Cmdlet in einer aktiven Terminalsitzung auszuführen.

Parameter

-Bestätigen

Fordert Sie vorher zur Bestätigung an, bevor das Cmdlet ausgeführt wird.

Typ: SwitchParameter
Parameter-Sätze: (Alle)
Aliase: cf
Erforderlich: False
Position: Benannt
Standardwert: Keiner
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: 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 Bitte um Bestätigung.

Typ: SwitchParameter
Parameter-Sätze: (Alle)
Aliase:
Erforderlich: Falsch
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: Falsch
Platzhalterzeichen akzeptieren: Falsch

-Name

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

Typ: String[]
Parameter-Sätze: (Alle)
Aliase:
Erforderlich: True
Position: 0
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: True (ByValue)
Platzhalterzeichen akzeptieren: Falsch

-WhatIf

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

Typ: SwitchParameter
Parameter-Sätze: (Alle)
Aliase: wi
Erforderlich: Falsch
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: Falsch
Platzhalterzeichen akzeptieren: Falsch

Gewöhnliche 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

Kein(e)

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

Zusätzliche Ressourcen

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