Compartir a través de

Move-CMObject

  • Referencia
Módulo:
ConfigurationManager

Mueva un objeto de Configuration Manager a otra carpeta.

Sintaxis

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

Description

El cmdlet Move-CMObject mueve un objeto de Configuration Manager a otra carpeta. Especifique el objeto que se va a mover y la carpeta de destino. Dado que un objeto solo existe en una carpeta, el cmdlet no especifica la carpeta actual.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Mover una aplicación por objeto

En este ejemplo se obtiene primero un objeto de aplicación por nombre. A continuación, mueve el objeto a la carpeta TestFolder.

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

Ejemplo 2: Mover una secuencia de tareas por identificador

En este ejemplo se mueve la secuencia de tareas con el identificador de paquete XYZ00550 a la carpeta Desarrollo .

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

Parámetros

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FolderPath

Especifica una ruta de acceso de carpeta de destino, en el formato siguiente: <site code>:\<object type>\folder\subfolder\subfolder.

  • <site code>: código de sitio de Configuration Manager.
  • <object type>: una de las siguientes palabras clave para el tipo de objeto que se va a mover:
    • Application
    • BootImage
    • ConfigurationBaseline
    • ConfigurationItem
    • DeviceCollection
    • Driver
    • DriverPackage
    • OperatingSystemImage
    • OperatingSystemInstaller
    • Package
    • Query
    • TaskSequence
    • UserCollection
    • UserStateMigration

Por ejemplo, una carpeta denominada APLICACIONES LOB para una aplicación en el sitio CM1 tiene la siguiente ruta de acceso de archivo: CM1:\Application\LOB Apps.

Para mover un objeto a la carpeta raíz, no especifique una carpeta. Por ejemplo, CM1:\Application.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifique una matriz de objetos de Configuration Manager que se van a mover. Si especifica una matriz, use el mismo tipo de objeto. Haga coincidir el tipo de objeto con la palabra clave usada con el parámetro -FolderPath .

Use uno de los siguientes cmdlets para obtener estos objetos:

Tipo:IResultObject[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ObjectId

Especifica una matriz de identificadores de objeto que se van a mover. Si especifica una matriz, use el mismo tipo de objeto. Haga coincidir el tipo de objeto con la palabra clave usada con el parámetro -FolderPath .

Por ejemplo, XYZ00550.

Tipo:String[]
Alias:InstanceKey
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Salidas

System.Object