Copy-CMSecurityRole

Создайте пользовательскую роль безопасности.

Синтаксис

Copy-CMSecurityRole
    [-Description <String>]
    -Name <String>
    -SourceRoleId <String>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Copy-CMSecurityRole
    [-Description <String>]
    -Name <String>
    -SourceRoleName <String>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Copy-CMSecurityRole
    [-Description <String>]
    -InputObject <IResultObject>
    -Name <String>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Используйте этот командлет, чтобы создать новую роль безопасности, используя существующую роль безопасности в качестве шаблона. Configuration Manager предоставляет несколько встроенных ролей безопасности. Если требуются дополнительные роли безопасности, можно создать пользовательскую роль безопасности, создав копию существующей роли безопасности, а затем изменив ее.

Дополнительные сведения о ролях безопасности и разрешениях см. в статье Основы ролевого администрирования в Configuration Manager.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Копирование роли безопасности с помощью идентификатора

Эта команда создает новую роль безопасности с именем SecRole02. Он копирует роль безопасности с идентификатором SMS000CR, который является ролью диспетчера обновлений программного обеспечения .

Copy-CMSecurityRole -Name "SecRole02" -SourceRoleId "SMS000CR"

Параметры

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Укажите необязательное описание роли безопасности.

Тип:String
Aliases:RoleDescription
Position:Named
Default value:None
Обязательно: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

-InputObject

Укажите объект роли безопасности для копирования. Чтобы получить этот объект, используйте командлет Get-CMSecurityRole .

Тип:IResultObject
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Укажите имя новой роли безопасности.

Тип:String
Aliases:RoleName
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SourceRoleId

Укажите идентификатор роли безопасности для копирования. Это значение является свойством RoleID , например SMS000AR для роли диспетчера развертывания ОС .

Тип:String
Aliases:CopiedFromId
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SourceRoleName

Укажите имя роли безопасности для копирования.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object