Add-CMUserAffinityToDevice

  • リファレンス
モジュール:
ConfigurationManager

Configuration Manager階層内の 1 つ以上のデバイスにプライマリ ユーザーを追加します。

構文

Add-CMUserAffinityToDevice
   -DeviceName <String[]>
   [-UserId <Int32[]>]
   [-UserName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserAffinityToDevice
   -DeviceId <Int32[]>
   [-UserId <Int32[]>]
   [-UserName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Add-CMUserAffinityToDevice コマンドレットは、デバイスをConfiguration Managerのプライマリ ユーザーに関連付けます。 プライマリ ユーザーに関連付けるデバイスは、その名前または ID で指定できます。 プライマリ ユーザーは、名前または ID で指定できます。

ユーザー デバイス アフィニティは、ユーザーを 1 つ以上の指定されたデバイスに関連付ける方法です。 これにより、すべてのユーザーのデバイスの名前を知る必要なく、ユーザーにアプリケーションをデプロイできます。 アプリケーションをユーザーのすべてのデバイスに展開する代わりに、アプリケーションをユーザーに展開し、そのユーザーに関連付けられているすべてのデバイスにアプリケーションが自動的にインストールされます。

注:

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

例

例 1: プライマリ ユーザーをデバイスに追加する

PS XYZ:\>Add-CMUserAffinityToDevice -DeviceName "CMCEN-DIST-02" -UserId "2063597981"

このコマンドは、2063597981 ID を持つプライマリ ユーザーを CMCEN-DIST-02 という名前のデバイスに追加します。

パラメーター

-Confirm

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

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

-DeviceId

プライマリ ユーザーに関連付けるデバイスの ID の配列を指定します。

Type:Int32[]
Aliases:ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DeviceName

プライマリ ユーザーに関連付けるデバイスの名前の配列を指定します。

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

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

-UserId

ユーザーの ID を指定します。

Type:Int32[]
Aliases:UserIds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserName

プライマリ ユーザーの名前を指定します。

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

-WhatIf

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

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

入力

None

出力

System.Object