Set-CMFolder

コンソールでフォルダーを構成します。

構文

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>]

説明

指定したフォルダーを構成するには、このコマンドレットを使用します。 たとえば、名前を変更したり、別のフォルダーに移動したりします。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例 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

例 2

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

例 3

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

例 4

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

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FolderPath

コンソール フォルダーへのパスを指定します。 たとえば、DeviceCollection\Folder1 のように指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Guid

構成するコンソール フォルダーの GUID を指定します。

型:Guid
Aliases:FolderGuid
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

構成するコンソール フォルダーの ID を指定します。

型:Int32
Aliases:ContainerNodeID
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

構成するフォルダー オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMFolder コマンドレットを使用します。

型:IResultObject
Aliases:ContainerNode
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-MoveToFolder

フォルダーを移動するには、ターゲット フォルダー オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMFolder コマンドレットを使用します。

型:IResultObject
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MoveToPath

フォルダーを移動するには、ターゲット フォルダーへのパスを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

構成するコンソール フォルダーの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-NewName

フォルダーの名前を変更するには、このパラメーターを使用します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ParentContainerNode

親コンテナーのフォルダー オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMFolder コマンドレットを使用します。

型:IResultObject
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ParentFolderPath

親フォルダーのパスを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object