Condividi tramite

Move-CMObject

  • Riferimento
Modulo:
ConfigurationManager

Spostare un oggetto 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 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 Configuration Manager cmdlet dall'unità del sito 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 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 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