New-CMAdministrativeUser
管理ユーザーを作成します。
構文
New-CMAdministrativeUser
[-CollectionName <String[]>]
-Name <String>
-RoleName <String[]>
[-SecurityScopeName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAdministrativeUser
-Name <String>
-Permission <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Configuration Manager の管理ユーザーを作成するには、このコマンドレットを使用します。 Configuration Manager の管理 ユーザーは、ローカル ユーザーまたはドメイン ユーザーまたはグループを定義します。 Configuration Manager で管理ユーザーを作成すると、セキュリティ ロール、セキュリティ スコープ、およびコレクションにアクセスできます。 セキュリティ ロールの詳細については、「Configuration Manager での役割ベースの管理の基本 」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。
例
例 1: 管理ユーザーを追加する
このコマンドは 、AdminUser1 という名前の Contoso ドメイン ユーザーを管理ユーザーとして追加します。 このユーザーは、アプリケーション管理者**** とソフトウェア更新マネージャーの組み込みのセキュリティ ロールに追加されます。 また、このコマンドは 、scope1とscope2のセキュリティ スコープ、および userCollection1 コレクションおよび deviceCollection1コレクションにユーザーを追加します。 ****
$name = "Contoso\AdminUser1"
$roles = "Application Administrator","Software Update Manager"
$scopes = "scope1","scope2"
$colls = "userCollection1","deviceCollection1"
New-CMAdministrativeUser -Name $name -RoleName $roles -SecurityScopeName $scopes -CollectionName $colls例 2: ドメイン グループを追加する
この例では、組み込みの読み取り専用アナリスト セキュリティ ロールに Contoso ドメイン グループ Security Analysts を 追加します。
New-CMAdministrativeUser -Name "Contoso\Security Analysts" -RoleName "Read-only Analyst"パラメーター
コレクション名の配列を指定します。 コマンドレットは、これらの各コレクションに新しい管理ユーザーを割り当てる。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットを実行する前に確認メッセージを表示します。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
追加する管理ユーザーの名前を指定します。 ユーザーまたはグループ domain\name name の形式を使用します。
| Type: | String |
| Aliases: | LogonName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
この新しいユーザーに割り当てるアクセス許可オブジェクトの配列を指定します。 これらのオブジェクトを取得するには 、New-CMAdministrativeUserPermission コマンドレットを使用 します。
| Type: | IResultObject[] |
| Aliases: | Permissions |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
セキュリティ ロール名の配列を指定します。 この名前は、組み込みロールまたはカスタム ロールに使用できます。 組み込みのセキュリティ ロールの一覧については、「セキュリティ ロール」 を参照してください。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
セキュリティ スコープ名の配列を指定します。 セキュリティ スコープ名には、"Default" またはカスタム セキュリティ スコープの名前を指定できます。 コマンドレットは、指定したセキュリティ スコープを管理ユーザーに割り当てる。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
None
出力
IResultObject
メモ
この戻り値オブジェクトとそのプロパティの詳細については、「SMS_Admin WMI クラス」を参照してください。