17.15 ioutils importpolicy (importing security policy settings)
Functionality
This command imports previously exported security policy settings. You can only import the files that were previously exported. If you do not specify a security policy name, the security policy is registered with the name of the previous export.
If you have multiple JP1/IT Desktop Management 2 systems configured, security policy settings created on one management server can be reused on another management server.
Execute this command on a management server.
Format
ioutils importpolicy -import import-file-name[ -name security-policy-name][ -applygroup update-group-name-to-apply][ -excludegroup excluded-update-group-name][ -s]
Argument
- -import import-file-name
-
Specify the absolute path (within 259 bytes) of the XML file to import.
- -name security-policy-name
-
Specify a security policy name to import. If this argument is omitted, the security policy name from a previous export will be used.
- -applygroup update-group-name-to-apply
-
Specify a name for the update group. If this argument is omitted, the update group name from a previous export will be applied.
- -excludegroup excluded-update-group-name
-
Specify a name for the excluded update group. If this argument is omitted, the excluded update group name from a previous export will be applied.
- -s
-
Overwrites the file even if a security policy with the same file name already exists. If this argument is not specified and a security policy with the same file name already exists, an overwrite confirmation message appears. In this case, the system cancels the input or overwrites the file according to the administrator's reply.
Storage location
JP1/IT Desktop Management 2-installation-folder\mgr\bin\
You can execute this command without specifying the storage location for the executable file, by using the command prompt provided by JP1/IT Desktop Management 2.
Notes
-
Execute this command when the management server setup is completed and the management server is running.
-
This command cannot be simultaneously executed by multiple users.
-
This command cannot be executed simultaneously with any of the following commands:
-
exportdb
-
importdb
-
ioassetsfieldutil export
-
ioassetsfieldutil import
-
ioutils exportasset
-
ioutils exportassetassoc
-
ioutils exportdevice
-
ioutils exportdevicedetail
-
ioutils exportfield
-
ioutils exportfilter
-
ioutils exportoplog
-
ioutils exportpolicy
-
ioutils exporttemplate
-
ioutils exportupdategroup
-
ioutils exportupdatelist
-
ioutils importasset
-
ioutils importassetassoc
-
ioutils importexlog
-
ioutils importfield
-
ioutils importfilter
-
ioutils importtemplate
-
ioutils importupdategroup
-
ioutils importupdatelist
-
reorgdb
-
startservice
-
stopservice
-
updatesupportinfo
-
deletenwgroup
-
deletepackage
-
distributelicense
-
-
When importing the exported security policy data containing tasks specified in it, the command checks whether the same task name already exists in the import destination folder. When the same task is detected, the task name being imported is prefixed with imp_N_ (where N is an integer that is at least 1). If the task name exceeds the size limit, excess characters are omitted from the last part of the task name.
Return value
The following table shows the return values of the ioutils importpolicy command.
Return value |
Description |
---|---|
0 |
The command finished normally. |
11 |
The specified format for the argument is incorrect. |
12 |
The specified folder is invalid, the disk does not have sufficient capacity, or the folder does not exist. |
31 |
Another command is being executed. |
51 |
You do not have the permissions to execute this command. |
54 |
The management server has not been set up. |
76 |
An invalid security policy name is specified. |
80 |
The format of the file being imported is invalid. |
83 |
No corresponding update group matches. |
101 |
Command execution failed because there is not enough memory, or due to some other reason. |
120 |
A database access error occurred. |
150 |
Command execution was interrupted due to some other error. |
Example
The following example shows use of this command to import the previously exported security policy settings file exportpolicy.xml into C:\temp\, as a import name "policy for a development group." The excluded update group name is assumed to be "updates not to import in Windows 7."
ioutils importpolicy -import C:\temp\exportpolicy.xml -name "policy for development group" -excludegroup "updates not to import in Windows 7." -s
Related Topics: