Condividi tramite

Move-CMObject

  • Riferimento
Modulo:
ConfigurationManager

Spostare un oggetto di Configuration Manager in una cartella diversa.

Sintassi

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

Descrizione

Il cmdlet Move-CMObject sposta un oggetto di Configuration Manager in una cartella diversa. Specificare l'oggetto da spostare e la cartella di destinazione. Poiché un oggetto esiste in una sola cartella, il cmdlet non specifica la cartella corrente.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Spostare un'app per oggetto

In questo esempio viene prima ottenuto un oggetto applicazione in base al nome. Sposta quindi l'oggetto nella cartella TestFolder.

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

Esempio 2: Spostare una sequenza di attività in base all'ID

In questo esempio la sequenza di attività con ID pacchetto XYZ00550 viene spostata nella cartella Development .

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

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FolderPath

Specifica un percorso di cartella di destinazione nel formato seguente: <site code>:\<object type>\folder\subfolder\subfolder.

  • <site code>: codice del sito di Configuration Manager.
  • <object type>: una delle parole chiave seguenti per il tipo di oggetto da spostare:
    • Applicazione
    • BootImage
    • ConfigurationBaseline
    • ConfigurationItem
    • DeviceCollection
    • Driver
    • Pacchetto driver
    • OperatingSystemImage
    • OperatingSystemInstaller
    • Pacchetto
    • Query
    • TaskSequence
    • UserCollection
    • UserStateMigration

Ad esempio, una cartella denominata Lob Apps per un'applicazione nel sito CM1 ha il percorso di file seguente: CM1:\Application\LOB Apps.

Per spostare un oggetto nella cartella radice, non specificare una cartella. Ad esempio, CM1:\Application.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare una matrice di oggetti di Configuration Manager da spostare. Se si specifica una matrice, usare lo stesso tipo di oggetto. Trovare la corrispondenza tra il tipo di oggetto e la parola chiave utilizzata con il parametro -FolderPath .

Usare uno dei cmdlet seguenti per ottenere questi oggetti:

Tipo:IResultObject[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ObjectId

Specifica una matrice di ID oggetto da spostare. Se si specifica una matrice, usare lo stesso tipo di oggetto. Trovare la corrispondenza tra il tipo di oggetto e la parola chiave utilizzata con il parametro -FolderPath .

Ad esempio, XYZ00550.

Tipo:String[]
Alias:InstanceKey
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Output

System.Object