Set-CIPolicyIdInfo.md

description	external help file	Module Name	ms.date	online version	schema	title
Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.	Microsoft.ConfigCI.Commands.dll-Help.xml	ConfigCI	12/20/2016	https://learn.microsoft.com/powershell/module/configci/set-cipolicyidinfo?view=windowsserver2022-ps&wt.mc_id=ps-gethelp	2.0.0	Set-CIPolicyIdInfo

Set-CIPolicyIdInfo

SYNOPSIS

Modifies the name and ID of a Code Integrity policy.

SYNTAX

Set-CIPolicyIdInfo [-FilePath] <String> [-PolicyName <String>] [-SupplementsBasePolicyID <Guid>]
 [-BasePolicyToSupplementPath <String>] [-ResetPolicyID] [-PolicyId <String>] [<CommonParameters>]

DESCRIPTION

The Set-CIPolicyIdInfo cmdlet modifies the policy name and policy ID of a Code Integrity policy. Specify the .xml file of the policy to modify. Event Tracing for Windows (ETW) events use the PolicyID and Name properties to identify which policy is currently running on a computer.

EXAMPLES

Example 1: Modify the ID and name of a policy

PS C:\> Set-CIPolicyIdInfo -FilePath ".\Policy03.xml" -PolicyId "CIP077" -PolicyName "CIPolicy03"

This command modifies the policy ID and the policy name for the policy stored in the Policy03.xml file.

Example 2: Modify the name of a policy

PS C:\> Set-CIPolicyIdInfo -FilePath ".\Policy03.xml" -PolicyName "CIPolicy77"

This command modifies only the policy name for the policy stored in the Policy03.xml file.

Example 3: Specify the base policy ID of a supplemental policy

PS C:\> Set-CIPolicyIdInfo -FilePath ".\Supplemental_Policy.xml" -BasePolicyToSupplementPath ".\Base_Policy.xml"

This command will extract the PolicyID field from the Base_Policy.xml file and modify the BasePolicyID field in the Supplemental_Policy.xml file.

PARAMETERS

-BasePolicyToSupplementPath

Specifies the path to a base policy to get the value for the BasePolicyID property for a supplemental policy.

Type: String
Parameter Sets: (All)
Aliases:

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

-FilePath

Specifies the path of a Code Integrity policy .xml file.

Type: String
Parameter Sets: (All)
Aliases: f

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PolicyId

Specifies the value for the PolicyID property. This string is not required to be a GUID.

Type: String
Parameter Sets: (All)
Aliases: pid

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

-PolicyName

Specifies the value for the Name property.

Type: String
Parameter Sets: (All)
Aliases: pn

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

-ResetPolicyID

Resets both the PolicyID and BasePolicyID values. This parameter will convert a single-policy format policy to multi-policy format.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-SupplementsBasePolicyID

Specifies the value for the BasePolicyID property for a supplemental policy.

Type: Guid
Parameter Sets: (All)
Aliases: None

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

RELATED LINKS

Get-CIPolicyIdInfo