Partilhar via


Move-CMObject

SYNOPSIS

Mova um objeto do Gestor de Configuração para uma pasta diferente.

SYNTAX

SearchByObjectMandatory (Padrão)

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

SearchByIdMandatory

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

DESCRIPTION

O cmdlet Move-CMObject move um objeto de Gestor de Configuração numa pasta diferente. Especifique o objeto para mover e a pasta de destino. Como existe um objeto numa única pasta, o cmdlet não especifica a pasta atual.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Mover uma aplicação por objeto

Este exemplo obtém primeiro um objeto de aplicação pelo 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 tarefa por ID

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

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

PARAMETERS

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-PastaPata

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 Gestor de Configuração.
  • <object type>: Uma das seguintes palavras-chave para o tipo de objeto mover-se:
    • Aplicação
    • BootImage
    • ConfiguraçãoBaseline
    • ConfiguraçãoItem
    • Configuração de dispositivos
    • Controlador
    • Pacote de motorista
    • OperatingSystemImage
    • Instalador operativoSystemInstall
    • Pacote
    • Query
    • TaskSequence
    • UserCollection
    • UserStateMigration

Por exemplo, uma pasta chamada LOB Apps 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.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Especifique um conjunto de objetos do Gestor de Configuração para se mover. Se especificar uma matriz, utilize o mesmo tipo de objeto. Combine o tipo de objeto com a palavra-chave utilizada com o parâmetro -FolderPath.

Utilize um dos seguintes cmdlets para obter estes objetos:

Type: IResultObject[]
Parameter Sets: SearchByObjectMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-ObjectId

Especifica uma matriz de identificações de objetos para mover. Se especificar uma matriz, utilize o mesmo tipo de objeto. Combine o tipo de objeto com a palavra-chave utilizada com o parâmetro -FolderPath.

Por exemplo, XYZ00550.

Type: String[]
Parameter Sets: SearchByIdMandatory
Aliases: InstanceKey

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

OUTPUTS

Sistema.Objeto

NOTAS

Lock-CMObject

Desbloqueie-CMObject