Remove-CMUserCollectionFromDistributionPointGroup

Remove-CMUserCollectionFromDistributionPointGroup

Removes a user collection from a distribution point group in Configuration Manager.

構文

Parameter Set: SearchByIdMandatory
Remove-CMUserCollectionFromDistributionPointGroup -DistributionPointGroupId <String> -UserCollectionName <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByNameMandatory
Remove-CMUserCollectionFromDistributionPointGroup -DistributionPointGroupName <String> -UserCollectionName <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Remove-CMUserCollectionFromDistributionPointGroup -InputObject <IResultObject> -UserCollectionName <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Remove-CMUserCollectionFromDistributionPointGroup cmdlet removes a user collection from a distribution point group in Microsoft System Center 2012 Configuration Manager. Distribution point groups contain distribution points that have a common purpose, such as supporting mobile device clients. A distribution point group simplifies tasks that involve the individual distribution points in a group.

パラメーター

-DistributionPointGroupId<String>

Specifies an ID of a distribution group in Configuration Manager.

エイリアス

GroupId

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-DistributionPointGroupName<String>

Specifies a name of a distribution point group in Configuration Manager.

エイリアス

GroupName

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Force

Performs the action without a confirmation message.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-InputObject<IResultObject>

Specifies a distribution point group object. To obtain a distribution point group object, use the Get-CMDistributionPointGroup cmdlet.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-UserCollectionName<String>

Specifies a name of a user collection in Configuration Manager.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

Example 1: Remove a user collection by name

This command removes a user collection from a distribution point group by using a distribution point group ID and a user collection name.

PS C:\> Remove-CMUserCollectionFromDistributionPointGroup -DistributionPointGroupId "DPG-01" -UserCollectionName "Mobile Users"

Example 2: Remove a user collection by distribution point group name

This command removes a user collection from a distribution point group by using a distribution point group name and a user collection name.

PS C:\> Remove-CMUserCollectionFromDistributionPointGroup -DistributionPointGroupName "All Downtown" -UserCollectionName "Mobile Users"

Example 3: Remove a user collection by input object

This command removes a user collection from a distribution point group by using an input object and a user collection.

PS C:\> Remove-CMUserCollectionFromDistributionPointGroup -InputObject IRObject-013 -UserCollectionName "All Remote"

関連トピック

Get-CMDistributionPointGroup

New-CMDistributionPointGroup

Set-CMDistributionPointGroup