Move-CMObject

  • Referencia
Módulo:
ConfigurationManager

Mueva un objeto Configuration Manager a otra carpeta.

Syntax

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 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 Configuration Manager, por ejemploPS 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Configuration Manager.
  • <object type>: una de las siguientes palabras clave para el tipo de objeto que se va a mover:
    • Aplicación
    • 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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique una matriz de Configuration Manager objetos 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:

Type:IResultObject[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Aliases:InstanceKey
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Salidas

System.Object