Add-CMUserCollectionDirectMembershipRule
直接メンバーシップ規則をユーザー コレクションに追加します。
構文
Add-CMUserCollectionDirectMembershipRule
-InputObject <IResultObject>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionDirectMembershipRule
-CollectionId <String>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionDirectMembershipRule
-CollectionId <String>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionDirectMembershipRule
-CollectionName <String>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionDirectMembershipRule
-CollectionName <String>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionDirectMembershipRule
-InputObject <IResultObject>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットを使用して、直接メンバーシップ規則をユーザー コレクションに追加します。
直接メンバーシップ規則を使用すると、ユーザー コレクションのメンバーを明示的に選択できます。
メンバーシップ ルールを既定のコレクションに追加することはできません。 ターゲットとするコレクションには、 SMSではなくサイト コードで始まる ID が必要です。
詳細については、「 Configuration Manager でコレクションを作成する方法」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 直接メンバーシップ規則をユーザー コレクションに追加する
このコマンドは、ID XYZ00057を使用して、直接メンバーシップ規則をユーザー コレクションに追加します。 ID 16777210 を持つリソースがコレクションに追加されます。
Add-CMUserCollectionDirectMembershipRule -CollectionId "XYZ00057" -ResourceId "16777210"パラメーター
-CollectionId
ルールを追加するユーザー コレクションの ID を指定します。 この値は CollectionID プロパティです (たとえば、 XYZ00012)。 既定のコレクションにメンバーシップ ルールを追加できないため、この ID はサイト コードで始まり、 SMSではありません。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CollectionName
ルールを追加するユーザー コレクションの名前を指定します。
| 型: | 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-CMCollection コマンドレットまたは Get-CMUserCollection コマンドレットを 使用します。
| 型: | IResultObject |
| Aliases: | Collection |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PassThru
このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Resource
この直接メンバーシップ規則を使用して、ユーザー コレクションに追加するリソース オブジェクトの配列を指定します。 このオブジェクトを取得するには、 Get-CMResource コマンドレットまたは Get-CMUser コマンドレットを 使用します。
| 型: | IResultObject[] |
| Aliases: | Resources |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ResourceId
この直接メンバーシップ規則を使用してユーザー コレクションに追加するリソースの ID の配列を指定します。 この値は ResourceID プロパティです (たとえば、 16777219)。
| 型: | Int32[] |
| Aliases: | ResourceIds |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
出力
System.Object