Copy-CMConfigurationPolicy

モジュール:

ConfigurationManager

構成ポリシーをコピーします。

構文

Copy-CMConfigurationPolicy
    [-InputObject] <IResultObject>
    [-NewName] <String>
    [-PassThru]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Copy-CMConfigurationPolicy
    [-Id] <Int32>
    [-NewName] <String>
    [-PassThru]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Copy-CMConfigurationPolicy
    [-Name] <String>
    [-NewName] <String>
    [-PassThru]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Copy-CMConfigurationPolicy は、構成ポリシーをコピーします。 構成ポリシーには、クライアント認証証明書プロファイル構成項目、ワイヤレス プロファイル構成項目などがあります。 このコマンドレットを使用してコピーできる追加のポリシー項目については、「エイリアス」セクションを参照してください。

注:

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

例

例 1: パイプラインを使用して構成ポリシーをコピーする

PS XYZ:\> Get-CMConfigurationPolicy -Name "TrustedCACert01" -Fast | Copy-CMConfigurationPolicy -NewName "TrustedCACert01_copy"

このコマンドは、TrustedCACert01 という名前の構成ポリシー オブジェクトを取得し、パイプライン演算子を使用してオブジェクトを Copy-CMConfiguratinPolicy に渡します。これにより、ポリシーのコピーが作成され、TrustedCACert01_copyという名前が付けられます。

例 2: ID で構成ポリシーをコピーする

PS XYZ:\> Copy-CMConfigurationPolicy -Id 16777454 -NewName "EmailProfile1_copy"

このコマンドは、ID が 16777454 の構成ポリシーのコピーを作成し、EmailProfile1_copyという名前を付けます。

パラメーター

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-Id

構成ポリシーのCI_IDを指定します。

Type:	Int32
Aliases:	CIId, CI_ID
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

構成ポリシー オブジェクトを取得します。 構成ポリシー オブジェクトを取得するには、Get-CMConfigurationPolicy コマンドレットを使用します。

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

-Name

構成ポリシーの名前を指定します。

Type:	String
Aliases:	LocalizedDisplayName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

構成ポリシーのコピーの名前を指定します。

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

-PassThru

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

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• Get-CMConfigurationPolicy
• Remove-CMConfigurationPolicy