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