Import-CMSecurityRole
Импорт роли безопасности из XML-файла.
Синтаксис
Import-CMSecurityRole
[-NewRoleName <String>]
-Overwrite <Boolean>
-XmlFileName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Используйте этот командлет для импорта роли безопасности из XML-файла. Ранее XML-код был экспортирован из Configuration Manager. Этот процесс экспорта и импорта можно использовать для резервного копирования пользовательских ролей безопасности или их копирования между отдельными иерархиями.
Например, вы разрабатываете пользовательскую роль безопасности в лабораторной среде. Экспортируйте эту новую роль из иерархии лаборатории, а затем импортируйте ее в рабочую иерархию.
Дополнительные сведения о ролях безопасности и разрешениях см. в статье Основы ролевого администрирования в Configuration Manager.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Импорт роли безопасности
Эта команда импортирует роль безопасности в Configuration Manager из XML-файла экспорта с именемRemoteAdminSecurity.xml. Команда указывает, что импортируемая роль безопасности перезаписывает существующую роль безопасности с тем же именем.
Import-CMSecurityRole -XmlFileName "RemoteAdminSecurity.xml" -Overwrite $True
Параметры
-Confirm
Перед запуском командлет запросит подтверждение.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-NewRoleName
Укажите имя новой роли безопасности. Если указать -Overwrite $false
значение , это значение переопределяет RoleName
свойство в XML-файле.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Overwrite
Задайте для этого параметра значение , $true
чтобы перезаписать существующую роль безопасности с тем же именем.
Тип: | Boolean |
Aliases: | OverwrittenExisted |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-XmlFileName
Укажите путь к XML-файлу для импорта роли безопасности. Это может быть локальный или сетевой путь.
.xml
Включите расширение файла.
Тип: | String |
Aliases: | FileName, FilePath, ImportFilePath, Path, RolesXml |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
System.Object