Import-CMSecurityRole

Imports a security role into Configuration Manager.

Syntax

Import-CMSecurityRole
      -Overwrite <Boolean>
      -XmlFileName <String>
      [-NewRoleName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Import-CMSecurityRole cmdlet imports a security role that was exported from another Microsoft System Center Configuration Manager hierarchy.

Examples

Example 1: Import a security role

PS C:\>Import-CMSecurityRole -Overwrite $True -XmlFileName "RemoteAdminSecurity.xml"

This command imports a security role into Configuration Manager from the XML export file named RemoteAdminSecurity. The command specifies that the security role that you import overwrites an existing security role with the same name.

Required Parameters

-Overwrite

Indicates whether the security role that you import overwrites an existing security role with the same name that you specify in the XmlFileName parameter.

Type:Boolean
Aliases:OverwrittenExisted
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-XmlFileName

Specifies the XML export file that contains the security role definition.

Type:String
Aliases:RolesXml, Path, FileName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

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

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewRoleName
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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