Add-CMSecurityRoleToAdministrativeUser

モジュール:

ConfigurationManager

ユーザーまたはグループにセキュリティ ロールを追加します。

構文

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 コマンドレットを使用して役割を取得できます。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: ドメイン ユーザー グループにカスタム セキュリティ ロールを追加する

このコマンドは、ドメイン グループ Western Administrators のカスタム セキュリティ ロール SecurityRole17 を追加します。 このコマンドは、カスタム セキュリティ ロールと管理ユーザーが既に作成済みである必要があります。

Add-CMSecurityRoleToAdministrativeUser -AdministrativeUserName "Contoso\Western Administrators " -RoleName "SecurityRole17"

パラメーター

-AdministrativeUser

構成する管理ユーザー オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMAdministrativeUser コマンドレットを使用 します。

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-AdministrativeUserId

構成する管理ユーザーの ID を指定します。 この値はプロパティ AdminID で、整数値です。 たとえば、「 16777234 」のように入力します。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AdministrativeUserName

構成する管理ユーザーの名前を指定します。

ワイルドカード文字を使用できます。

• *: 複数の文字
• ?: 1 文字

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

追加するセキュリティ 役割オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMSecurityRole コマンドレットを使用 します。

Type:	IResultObject
Aliases:	Role
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-RoleId

追加するセキュリティ ロールの ID を指定します。 この値は、OS Deployment Manager の役割など、 RoleID SMS000AR プロパティ です。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RoleName

追加するセキュリティ ロールの名前を指定します。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• Remove-CMSecurityRoleFromAdministrativeUser
• Add-CMSecurityScopeToAdministrativeUser
• Get-CMAdministrativeUser
• Get-CMSecurityRole
• ロール ベースの管理を自動化するには、Windows PowerShell