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>] 説明
このコマンドレットを使用して、Configuration Manager の管理ユーザーまたは管理グループにセキュリティ ロールを追加します。
ロールで定義されているアクセス許可は、オブジェクトの種類と、オブジェクトの種類ごとに使用できるアクションを表します。 Configuration Manager には、いくつかの組み込みのセキュリティ ロールが用意されています。 カスタム セキュリティ ロールを作成することもできます。 セキュリティ ロールの詳細については、「 Configuration Manager でのロールベースの管理の基礎」を参照してください。
管理者ユーザーまたはグループを名前または ID で指定するか、 Get-CMAdministrativeUser コマンドレットを使用してユーザーまたはグループ オブジェクトを取得できます。 Configuration Manager の 管理ユーザー は、ローカル ユーザーまたはドメイン ユーザーまたはグループを定義します。 名前または ID で追加するロールを指定することも、 Get-CMSecurityRole コマンドレットを使用してロールを取得することもできます。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: ドメイン ユーザー グループにカスタム セキュリティ ロールを追加する
このコマンドは、ドメイン グループ Western Administrators のカスタム セキュリティ ロール SecurityRole17 を追加します。 このコマンドは、カスタム セキュリティ ロールと管理ユーザーを既に作成していることを前提としています。
Add-CMSecurityRoleToAdministrativeUser -AdministrativeUserName "Contoso\Western Administrators " -RoleName "SecurityRole17"パラメーター
-AdministrativeUser
構成する管理ユーザー オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMAdministrativeUser コマンドレットを使用します 。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-AdministrativeUserId
構成する管理ユーザーの ID を指定します。 この値は、 AdminID プロパティです。これは整数値です。 たとえば、「 16777234 」のように入力します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AdministrativeUserName
構成する管理ユーザーの名前を指定します。
ワイルドカード文字を使用できます。
-
*: 複数の文字 -
?: 1 文字
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
追加するセキュリティ ロール オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMSecurityRole コマンドレットを 使用します。
| 型: | IResultObject |
| Aliases: | Role |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-RoleId
追加するセキュリティ ロールの ID を指定します。 この値は、OS Deployment Manager ロールのSMS000ARなど、RoleID プロパティです。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RoleName
追加するセキュリティ ロールの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object