Freigeben über


Copy-CMConfigurationPolicy

Kopiert eine Konfigurationsrichtlinie.

Syntax

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

Beschreibung

Copy-CMConfigurationPolicy kopiert eine Konfigurationsrichtlinie. Eine Konfigurationsrichtlinie kann ein Konfigurationselement für das Clientauthentifizierungszertifikat, ein Konfigurationselement für drahtlose Profile oder andere sein. Weitere Richtlinienelemente, die Sie mit diesem Cmdlet kopieren können, finden Sie im Abschnitt Alias.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Kopieren einer Konfigurationsrichtlinie mithilfe der Pipeline

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

Dieser Befehl ruft das Konfigurationsrichtlinienobjekt mit dem Namen TrustedCACert01 ab und verwendet den Pipelineoperator, um das Objekt an Copy-CMConfiguratinPolicy zu übergeben. Dadurch wird eine Kopie der Richtlinie erstellt und TrustedCACert01_copy.

Beispiel 2: Kopieren einer Konfigurationsrichtlinie nach ID

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

Dieser Befehl macht eine Kopie der Konfigurationsrichtlinie mit der ID 16777454 und benennt sie EmailProfile1_copy.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Gibt die CI_ID einer Konfigurationsrichtlinie an.

Typ:Int32
Aliase:CIId, CI_ID
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Ruft ein Konfigurationsrichtlinienobjekt ab. Verwenden Sie das Cmdlet Get-CMConfigurationPolicy, um ein Konfigurationsrichtlinienobjekt abzurufen.

Typ:IResultObject
Aliase:ConfigurationPolicy
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen einer Konfigurationsrichtlinie an.

Typ:String
Aliase:LocalizedDisplayName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NewName

Gibt einen Namen für die Kopie der Konfigurationsrichtlinie an.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object