Share via

Move-CMObject

  • Referência
Módulo:
ConfigurationManager

Mova um objeto Configuration Manager para uma pasta diferente.

Syntax

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

Description

O cmdlet Move-CMObject move um objeto Configuration Manager para uma pasta diferente. Especifique o objeto a ser movido e a pasta de destino. Como existe um objeto em apenas uma pasta, o cmdlet não especifica a pasta atual.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: mover um aplicativo por objeto

Este exemplo primeiro obtém um objeto de aplicativo pelo nome. Em seguida, ele move o objeto para a pasta TestFolder.

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

Exemplo 2: mover uma sequência de tarefas por ID

Este exemplo move a sequência de tarefas com a ID do pacote XYZ00550 para a pasta Desenvolvimento .

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

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-FolderPath

Especifica um caminho de pasta de destino, no seguinte formato: <site code>:\<object type>\folder\subfolder\subfolder.

  • <site code>: o código do site Configuration Manager.
  • <object type>: uma das seguintes palavras-chave para o tipo de objeto a ser movido:
    • Aplicativo
    • BootImage
    • ConfigurationBaseline
    • ConfigurationItem
    • DeviceCollection
    • Driver
    • DriverPackage
    • OperatingSystemImage
    • OperatingSystemInstaller
    • Pacote
    • Query
    • TaskSequence
    • Usercollection
    • UserStateMigration

Por exemplo, uma pasta chamada Aplicativos LOB para um aplicativo no site CM1 tem o seguinte caminho de arquivo: CM1:\Application\LOB Apps.

Para mover um objeto para a pasta raiz, não especifique uma pasta. Por exemplo, CM1:\Application.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-InputObject

Especifique uma matriz de objetos Configuration Manager a serem movidos. Se você especificar uma matriz, use o mesmo tipo de objeto. Corresponda o tipo de objeto com a palavra-chave usada com o parâmetro -FolderPath .

Use um dos seguintes cmdlets para obter esses objetos:

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

-ObjectId

Especifica uma matriz de IDs de objeto a serem movidas. Se você especificar uma matriz, use o mesmo tipo de objeto. Corresponda o tipo de objeto com a palavra-chave usada com o parâmetro -FolderPath .

Por exemplo, XYZ00550.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Saídas

System.Object