Move-CMObject

  • Referenz
Modul:
ConfigurationManager

Verschieben sie ein Configuration Manager-Objekt in einen anderen Ordner.

Syntax

Move-CMObject
    -FolderPath <String>
    -InputObject <IResultObject[]>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Move-CMObject
    -FolderPath <String>
    -ObjectId <String[]>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Move-CMObject verschiebt ein Configuration Manager-Objekt in einen anderen Ordner. Geben Sie das zu verschiebende Objekt und den Zielordner an. Da ein Objekt nur in einem Ordner vorhanden ist, gibt das Cmdlet den aktuellen Ordner nicht an.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Verschieben einer App nach Objekt

In diesem Beispiel wird zunächst ein Anwendungsobjekt anhand des Namens abgerufen. Anschließend wird das Objekt in den Ordner TestFolder verschoben.

$app = Get-CMApplication -Name "Teams"
Move-CMObject -FolderPath "XYZ:\Application\TestFolder" -InputObject $app

Beispiel 2: Verschieben einer Tasksequenz nach ID

In diesem Beispiel wird die Tasksequenz mit der Paket-ID XYZ00550 in den Ordner Entwicklung verschoben.

Move-CMObject -FolderPath "XYZ:\TaskSequence\Development" -ObjectId "XYZ00550"

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FolderPath

Gibt einen Zielordnerpfad im folgenden Format an: <site code>:\<object type>\folder\subfolder\subfolder.

  • <site code>: Der Configuration Manager-Standortcode.
  • <object type>: Eines der folgenden Schlüsselwörter für den Typ des zu verschiebenden Objekts:
    • Application
    • BootImage
    • ConfigurationBaseline
    • ConfigurationItem
    • DeviceCollection
    • Driver
    • DriverPackage
    • OperatingSystemImage
    • OperatingSystemInstaller
    • Package
    • Query
    • TaskSequence
    • UserCollection
    • UserStateMigration

Beispielsweise weist ein Ordner mit dem Namen BRANCHEN-Apps für eine Anwendung am Standort CM1 den folgenden Dateipfad auf: CM1:\Application\LOB Apps.

Um ein Objekt in den Stammordner zu verschieben, geben Sie keinen Ordner an. Beispiel: CM1:\Application.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Geben Sie ein Array von Configuration Manager-Objekten an, die verschoben werden sollen. Wenn Sie ein Array angeben, verwenden Sie denselben Objekttyp. Zuordnen des Objekttyps mit dem Schlüsselwort, das mit dem Parameter -FolderPath verwendet wird.

Verwenden Sie eines der folgenden Cmdlets, um diese Objekte abzurufen:

Typ:IResultObject[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ObjectId

Gibt ein Array von zu verschiebenden Objekt-IDs an. Wenn Sie ein Array angeben, verwenden Sie denselben Objekttyp. Zuordnen des Objekttyps mit dem Schlüsselwort, das mit dem Parameter -FolderPath verwendet wird.

Beispiel: XYZ00550.

Typ:String[]
Aliase:InstanceKey
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Ausgaben

System.Object