Share via

Set-CMFolder

  • Referência
Módulo:
ConfigurationManager

Configure uma pasta no console.

Syntax

Set-CMFolder
   -Name <String>
   [-ParentContainerNode <IResultObject>]
   [-ParentFolderPath <String>]
   [-NewName <String>]
   [-MoveToPath <String>]
   [-MoveToFolder <IResultObject>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMFolder
   -Id <Int32>
   [-NewName <String>]
   [-MoveToPath <String>]
   [-MoveToFolder <IResultObject>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMFolder
   -Guid <Guid>
   [-NewName <String>]
   [-MoveToPath <String>]
   [-MoveToFolder <IResultObject>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMFolder
   -FolderPath <String>
   [-NewName <String>]
   [-MoveToPath <String>]
   [-MoveToFolder <IResultObject>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMFolder
   -InputObject <IResultObject>
   [-NewName <String>]
   [-MoveToPath <String>]
   [-MoveToFolder <IResultObject>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para configurar a pasta especificada. Por exemplo, renomeie-o ou mova-o para outra pasta.

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

$parentPath = 'DeviceCollection'
$name =  'Folder1'
$name2 =  'Folder2'
$name3 =  'Folder3'
$root = New-CMFolder -ParentFolderPath $parentPath -Name $name
Set-CMFolder -Name $name2 -ParentContainerNode (Get-CMFolder -Name $name) -NewName $newName

Exemplo 2

(Get-CMFolder -Name $newName) | Set-CMFolder -NewName $name2

Exemplo 3

$folder = Set-CMFolder -Name $name3 -ParentFolderPath ($parentPath + '\' + $name + '\' + $name2) -MoveToFolder $root

Exemplo 4

$folder = Set-CMFolder -Guid $sub2.FolderGuid -MoveToPath ($parentPath + '\' + $name + '\' + $name2)

Parâmetros

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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

Especifique o caminho para a pasta do console. Por exemplo, DeviceCollection\Folder1

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

-Guid

Especifique o GUID da pasta de console a ser configurada.

Type:Guid
Aliases:FolderGuid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifique a ID da pasta de console a ser configurada.

Type:Int32
Aliases:ContainerNodeID
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique um objeto de pasta a ser configurado. Para obter esse objeto, use o cmdlet Get-CMFolder .

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

-MoveToFolder

Para mover uma pasta, especifique o objeto de pasta de destino. Para obter esse objeto, use o cmdlet Get-CMFolder .

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

-MoveToPath

Para mover uma pasta, especifique o caminho para a pasta de destino.

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

-Name

Especifique o nome da pasta de console a ser configurada.

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

-NewName

Use esse parâmetro para renomear a pasta.

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

-ParentContainerNode

Especifique um objeto de pasta para o contêiner pai. Para obter esse objeto, use o cmdlet Get-CMFolder .

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

-ParentFolderPath

Especifique o caminho da pasta pai.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object