Add-CMDeviceCollectionDirectMembershipRule
デバイス コレクションに直接メンバーシップ ルールを追加します。
構文
Add-CMDeviceCollectionDirectMembershipRule
-CollectionId <String>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-CollectionId <String>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-CollectionName <String>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-CollectionName <String>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-InputObject <IResultObject>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-InputObject <IResultObject>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットを使用して、デバイス コレクションに直接メンバーシップ ルールを追加します。
直接 メンバーシップ ルールを使用すると、デバイス コレクションのメンバーを明示的に選択できます。
既定のコレクションにメンバーシップ ルールを追加できない。 ターゲットとするコレクションには、サイト コードで始まる ID を持つ必要があります SMS
。
詳細については 、「Configuration Manager でコレクションを作成する方法」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1: 直接メンバーシップ ルールを追加する
このコマンドは、ID XYZ00056を持つデバイス コレクションに直接メンバーシップ ルールを追加します。 ID を持つリソースをコレクション 16777219 追加します。
Add-CMDeviceCollectionDirectMembershipRule -CollectionId "XYZ00056" -ResourceId 16777219
例 2: パイプラインを使用して直接メンバーシップ ルールを追加する
このコマンドは、 まず Get-CMCollection コマンドレットを使用して testCollectionという名前のコレクション オブジェクトを取得します。 次に、パイプライン 演算子を使用してオブジェクトを Add-CMDeviceCollectionDirectMembershipRule コマンドレットに渡し、デバイス コレクション オブジェクトに直接メンバーシップ ルールを追加します。 ID を持つデバイスをコレクション 16777219 追加します。
Get-CMCollection -Name "testCollection" | Add-CMDeviceCollectionDirectMembershipRule -ResourceId 16777219
パラメーター
-CollectionId
ルールを追加するデバイス コレクションの ID を指定します。 この値は 、CollectionID プロパティです。たとえば XYZ00012
、 です。 既定のコレクションにメンバーシップ ルールを追加できないので、この ID はサイト コードではなく、 で始まります SMS
。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
ルールを追加するデバイス コレクションの名前を指定します。
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-CMCollection コマンドレット または Get-CMDeviceCollection コマンドレット を使用します。
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
このパラメーターを追加して、作業しているアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Resource
この直接メンバーシップ ルールを使用して、デバイス コレクションに追加するリソース オブジェクトの配列を指定します。 このオブジェクトを取得するには 、Get-CMResource コマンドレットまたは Get-CMDevice コマンドレットをパラメーターと一緒に使用 -Resource
します。
Type: | IResultObject[] |
Aliases: | Resources |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceId
この直接メンバーシップ ルールを使用して、デバイス コレクションに追加するリソースの ID の配列を指定します。 この値は ResourceID プロパティです 16777219
。たとえば、 です。
Type: | Int32[] |
Aliases: | ResourceIds |
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