Move-CMObject

  • Referência
Módulo:
ConfigurationManager

Mover um objeto do Configuration Manager para uma pasta diferente.

Sintaxe

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 do Configuration Manager para uma pasta diferente. Especifique o objeto a mover e a pasta de destino. Uma vez que um objeto existe apenas numa pasta, o cmdlet não especifica a pasta atual.

Observação

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

Exemplos

Exemplo 1: Mover uma aplicação por objeto

Este exemplo obtém primeiro um objeto de aplicação por nome. Em seguida, 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 o 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.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 do Configuration Manager.
  • <object type>: uma das seguintes palavras-chave para o tipo de objeto a mover:
    • Application
    • BootImage
    • ConfigurationBaseline
    • ConfigurationItem
    • DeviceCollection
    • Driver
    • DriverPackage
    • OperatingSystemImage
    • OperatingSystemInstaller
    • Pacote
    • Query
    • TaskSequence
    • UserCollection
    • UserStateMigration

Por exemplo, uma pasta denominada Aplicações LOB para uma aplicação no site CM1 tem o seguinte caminho de ficheiro: CM1:\Application\LOB Apps.

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique uma matriz de objetos do Configuration Manager a mover. Se especificar uma matriz, utilize o mesmo tipo de objeto. Corresponda o tipo de objeto com a palavra-chave utilizada com o parâmetro -FolderPath .

Utilize um dos seguintes cmdlets para obter estes objetos:

Tipo:IResultObject[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ObjectId

Especifica uma matriz de IDs de objeto a mover. Se especificar uma matriz, utilize o mesmo tipo de objeto. Corresponda o tipo de objeto com a palavra-chave utilizada com o parâmetro -FolderPath .

Por exemplo, XYZ00550.

Tipo:String[]
Aliases:InstanceKey
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Saídas

System.Object