New-CMAdministrativeUserPermission

モジュール:

ConfigurationManager

管理ユーザーに割り当てるアクセス許可オブジェクトを作成します。

構文

New-CMAdministrativeUserPermission
   [-Collection <IResultObject[]>]
   [-CollectionId <String[]>]
   [-CollectionName <String[]>]
   -InputObject <IResultObject>
   [-SecurityScope <IResultObject[]>]
   [-SecurityScopeId <String[]>]
   [-SecurityScopeName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

New-CMAdministrativeUserPermission
   [-Collection <IResultObject[]>]
   [-CollectionId <String[]>]
   [-CollectionName <String[]>]
   -RoleId <String>
   [-SecurityScope <IResultObject[]>]
   [-SecurityScopeId <String[]>]
   [-SecurityScopeName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

New-CMAdministrativeUserPermission
   [-Collection <IResultObject[]>]
   [-CollectionId <String[]>]
   [-CollectionName <String[]>]
   -RoleName <String>
   [-SecurityScope <IResultObject[]>]
   [-SecurityScopeId <String[]>]
   [-SecurityScopeName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

説明

このコマンドレットを使用して、Configuration Manager で管理ユーザーに割り当てるアクセス許可オブジェクトを作成します。 アクセス許可には、セキュリティ ロール、セキュリティ スコープ、またはコレクションを含めできます。 Configuration Manager の管理 ユーザーは、ローカル ユーザーまたはドメイン ユーザーまたはグループを定義します。 セキュリティ ロールの詳細については、「Configuration Manager での役割ベースの管理の基本 」を参照してください。

New-CMAdministrativeUser コマンドレットとその Permission パラメーターで、このアクセス許可オブジェクトを使用します。

注意

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

例

例 1

この例では、次のアクセス許可を定義するオブジェクトを作成します。

• セキュリティ ロール: 読み取り専用アナリスト
• セキュリティ スコープ: Scope1
• コレクション: すべてのシステム

その後 、contoso\jqpublic の新しい管理ユーザーを作成し、これらのアクセス許可を割り当てる。 最後のコマンドは、新しいユーザーのアクセス許可を表示します。

$accountName = "contoso\jqpublic"
$roleName = "Read-only Analyst"
$scopeName = "Scope1"
$collectionName = "All Systems"

$role = Get-CMSecurityRole -Name $roleName
$scope = Get-CMSecurityScope -Name $scopeName
$collection = Get-CMCollection -Name $collectionName

$perms = $role | New-CMAdministrativeUserPermission -RoleName $role.RoleName -SecurityScopeNames $scope.CategoryName -CollectionNames $collection.Name

$User = New-CMAdministrativeUser -Name $accountName -Permission $perms
$User.Permissions

パラメーター

-Collection

アクセス許可に追加するコレクション オブジェクトの配列を指定します。 このオブジェクトを取得するには 、Get-CMCollection コマンドレットを使用 します。

Type:	IResultObject[]
Aliases:	Collections
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionId

アクセス許可に追加するコレクションの ID の配列を指定します。 この値は 、CollectionID プロパティです。たとえば SMS00001 、 です。

Type:	String[]
Aliases:	CollectionIds
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

アクセス許可に追加するコレクション名の配列を指定します。

Type:	String[]
Aliases:	CollectionNames
Position:	Named
Default value:	None
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

-SecurityScope

アクセス許可に追加するセキュリティ スコープ オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMSecurityScope コマンドレットを使用 します。

Type:	IResultObject[]
Aliases:	SecurityScopes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SecurityScopeId

アクセス許可に追加するセキュリティ スコープの ID を指定します。 この値は、 CategoryID 既定のスコープの SMS00UNA プロパティです****。

Type:	String[]
Aliases:	SecurityScopeIds
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SecurityScopeName

アクセス許可に追加するセキュリティ スコープの名前を指定します。

Type:	String[]
Aliases:	SecurityScopeNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

メモ

この戻り値オブジェクトとそのプロパティの詳細については、「SMS_APermission WMI クラス」を参照してください。

関連リンク

• New-CMAdministrativeUser
• ロール ベースの管理を自動化するには、Windows PowerShell