Powershell: Entfernen von NinjaTag

Thema

In diesem Artikel wird erläutert, wie Sie mit „Remove-NinjaTag“ ein bestimmtes System-Tag von einem Gerät entfernen 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 „Remove-NinjaTag“ entfernt ein oder mehrere angegebene System-Tags vom aktuellen Gerät. System-Tags sind vordefinierte Tags in der NinjaOne-Plattform, die zur Kategorisierung und Verwaltung von Geräten verwendet werden können. Das Cmdlet entfernt die angegebenen Tags vom aktuellen Gerät, ohne andere zugewiesene 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

Remove-NinjaTag [-Name] <STRING[]> [-Force] [-WhatIf] [-Confirm] [<COMMONPARAMETERS>]

Beispiele

Beispiel 1: Entfernen aus einem Automatisierungsskript

PS C:> Remove-NinjaTag -Name "IIS"

Das angegebene System-Tag „IIS“ wird vom Gerät entfernt.

Beispiel 2: Vom aktiven Terminal entfernen

PS C:> Remove-NinjaTag -Name "IIS"
Remove-NinjaTag : Der Zugang zu Tags ist nur von einem Automatisierungsskript möglich
In Zeile: 1, Zeichen: 1
+ Remove-NinjaTag -Name "IIS"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : FromStdErr: (:) [Write-Error],
WriteErrorException
+ FullyQualifiedErrorId :
Microsoft.Powershell.Befehle.WriteErrorException,Remove-NinjaTag

Tags können nur über ein Skript für Automatisierungen entfernt werden, daher wird eine Fehlernachricht ausgegeben, wenn versucht wird, das Cmdlet in einer aktiven Terminalsitzung auszuführen.

Parameter

-Bestätigen

Fordert Sie vorher zum Bestätigen des Cmdlets auf.

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

-Force

Wenn „confirm“ nicht angegeben ist und das Cmdlet normalerweise einen Bitte um 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: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-Name

Der Name der System-Tags, die vom Gerät entfernt werden sollen. Dieser Parameter akzeptiert ein Array von Zeichenfolgen, sodass Sie mehrere zu entfernende Tags in einem einzigen Befehl angeben können.

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

-WhatIf

Zeigt an, 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: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

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[]

Ein Array von Zeichenfolgen, die die Namen der System-Tags darstellen, die vom Gerät entfernt werden sollen. Diese Eingabe kann über die Pipeline oder als Parameter bereitgestellt werden.

Ausgaben

Kein(e)

Dieses Cmdlet muss innerhalb eines Ninja-Automatisierungsskripts ausgeführt werden, um die Tags eines
-Geräts 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 erfolgt.

Zusätzliche Ressourcen

Weitere Informationen zur Bestandsverwaltung und zur Erstellung benutzerdefinierter Skripte finden Sie in den folgenden Ressourcen: