Import-CMSecurityRole

Import-CMSecurityRole

Imports a security role into Configuration Manager.

Syntax

Parameter Set: Default
Import-CMSecurityRole -Overwrite <Boolean> -XmlFileName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

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

Parameters

-Overwrite<Boolean>

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

Aliases

OverwrittenExisted

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-XmlFileName<String>

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

Aliases

RolesXml

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Import a security role

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.

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

Copy-CMSecurityRole

Export-CMSecurityRole

Get-CMSecurityRole

Remove-CMSecurityRole

Remove-CMSecurityRoleFromAdministrativeUser

Set-CMSecurityRole