Export-CMCollection
コレクションをエクスポートします。
構文
Export-CMCollection
[-ExportComment <String>]
-ExportFilePath <String>
[-Force]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Export-CMCollection
-CollectionId <String>
[-ExportComment <String>]
-ExportFilePath <String>
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Export-CMCollection
[-ExportComment <String>]
-ExportFilePath <String>
[-Force]
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
コレクション オブジェクトをマネージド オブジェクト形式 (.mof
) ファイルに保存するには、このコマンドレットを使用します。
その後、同じまたは別の Configuration Manager サイトにインポートできます。 このエクスポート/インポート プロセスを使用して、カスタム コレクションをバックアップしたり、開発ライフサイクルに使用したりできます。 たとえば、ラボ環境で新しいコレクションを開発します。 テスト環境からコレクションをエクスポートし、運用環境階層にインポートします。
詳細については、「 Configuration Manager でコレクションを管理する方法」を参照してください。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 名前でコレクションをエクスポートする
このコマンドは、 testUser という名前のコレクションを collection.mof という名前のファイルにエクスポートします。
Export-CMCollection -Name "testUser" -ExportFilePath "C:\collection.mof"
例 2: すべてのコレクションをエクスポートする
この例では、最初に Get-CMCollection コマンドレットを使用してすべてのコレクションを取得し、 allColl 変数に格納します。 その後、各コレクションをループし、別のファイルにエクスポートします。 コレクション名 ($coll.Name
) をファイル名として使用します。
$allColl = Get-CMCollection
foreach ( $coll in $allcoll ) {
Export-CMCollection -InputObject $coll -ExportFilePath "D:\Export\Collections\$($coll.Name).mof"
}
パラメーター
-CollectionId
エクスポートするコレクションの ID を指定します。 この値は CollectionID プロパティです (たとえば、 XYZ00012
)。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ExportComment
MOF ファイル内のエクスポートされたコレクションの省略可能なコメントを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ExportFilePath
エクスポート ファイルの完全パスを指定します。 ファイル拡張子を .mof
含めます。
型: | String |
Aliases: | FileName, FilePath, Path |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
確認を求めずにコマンドを実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
エクスポートするコレクション オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCollection、 Get-CMDeviceCollection、または Get-CMUserCollection コマンドレットを 使用します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
エクスポートするコレクションの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object