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>] Description
使用此 Cmdlet 來建立新的安全性角色，方法是使用現有的安全性角色作為範本。 Configuration Manager 提供數個內建安全性角色。 如果您需要其他安全性角色，您可以建立現有安全性角色的複本，然後修改複本，以建立自定義安全性角色。
如需安全性角色和許可權的詳細資訊，請參閱 Configuration Manager 中以角色為基礎的系統管理基本概念。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：使用標識碼複製安全性角色
此命令會建立名為 SecRole02 的新安全性角色。 它會複製標識碼 SMS000CR為 的安全性角色，也就是 軟體更新管理員 角色。
Copy-CMSecurityRole -Name "SecRole02" -SourceRoleId "SMS000CR"參數
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
指定安全性角色的選擇性描述。
| 類型: | String |
| 別名: | RoleDescription |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
指定要複製的安全性角色物件。 若要取得此物件，請使用 Get-CMSecurityRole Cmdlet。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定新安全性角色的名稱。
| 類型: | String |
| 別名: | RoleName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SourceRoleId
指定要複製的安全性角色識別碼。 此值是 RoleID 屬性，例如 SMS000AROS部署管理員 角色。
| 類型: | String |
| 別名: | CopiedFromId |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SourceRoleName
指定要複製的安全性角色名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object