Import-CMSecurityRole

Imports a security role into Configuration Manager.

Syntax

Import-CMSecurityRole
      [-Confirm]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-NewRoleName <String>]
      -Overwrite <Boolean>
      [-WhatIf]
      -XmlFileName <String>
      [<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
Required:True
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
Required:True
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
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

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

Indicates that wildcard handling is enabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewRoleName
Type:String
Required:False
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
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False