Add-CMSecurityRoleToAdministrativeUser
將安全性角色新增至使用者或群組。
語法
Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUserName <String>
-RoleName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUser <IResultObject>
-RoleId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUser <IResultObject>
-RoleName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUser <IResultObject>
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUserId <Int32>
-RoleId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUserId <Int32>
-RoleName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUserId <Int32>
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUserName <String>
-RoleId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUserName <String>
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
使用此 Cmdlet 將安全性角色新增至 Configuration Manager 中的系統管理使用者或系統管理群組。
角色中定義的許可權代表每個物件類型可用的物件類型和動作。 Configuration Manager 提供一些內建的安全性角色。 您也可以建立自定義安全性角色。 如需安全性角色的詳細資訊，請參閱 Configuration Manager 中以角色為基礎的系統管理基本概念。
您可以依名稱或識別碼指定系統管理使用者或群組，也可以使用 Get-CMAdministrativeUser Cmdlet 來取得使用者或群組物件。 Configuration Manager 中的 系統管理用戶 會定義本機或網域使用者或群組。 您可以依名稱或標識碼指定要新增的角色，也可以使用 Get-CMSecurityRole Cmdlet 來取得角色。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：將自定義安全性角色新增至網域使用者群組
此命令會為網域群組「西部系統管理員」新增自定義安全性角色 SecurityRole17。 此命令假設您已建立自訂安全性角色和系統管理使用者。
Add-CMSecurityRoleToAdministrativeUser -AdministrativeUserName "Contoso\Western Administrators " -RoleName "SecurityRole17"參數
-AdministrativeUser
指定要設定的系統管理用戶物件。 若要取得此物件，請使用 Get-CMAdministrativeUser Cmdlet。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-AdministrativeUserId
指定要設定之系統管理使用者的識別碼。 這個值是 AdminID 屬性，也就是整數值。 例如，16777234。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AdministrativeUserName
指定要設定的系統管理用戶名稱。
您可以使用通配符：
-
*：多個字元 -
?：單一字元
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | 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 |
| 別名: | Role |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-RoleId
指定要新增的安全性角色識別碼。 此值是 RoleID 屬性，例如 SMS000AROS部署管理員 角色。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RoleName
指定要新增的安全性角色名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object