Add-CMDeviceAffinityToUser
Configuration Manager ユーザーにデバイス アフィニティを追加します。
構文
Add-CMDeviceAffinityToUser
[-DeviceId <Int32[]>]
[-DeviceName <String[]>]
-UserName <String[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMDeviceAffinityToUser
[-DeviceId <Int32[]>]
[-DeviceName <String[]>]
-UserId <Int32>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Add-CMDeviceAffinityToUser コマンドレットは、Configuration Manager のユーザーにデバイス アフィニティを追加します。
Configuration Manager のデバイス アフィニティは、ユーザーを 1 つ以上のデバイスに関連付けます。 アプリケーションをすべてのユーザーのデバイスに展開する代わりに、アプリケーションをユーザーに展開し、Configuration Manager によって、そのユーザーに関連付けられているすべてのデバイスにアプリケーションが自動的にインストールされます。 デバイス アフィニティを使用すると、そのユーザーのアプリケーションを展開する前に、Configuration Manager がユーザーのデバイスの名前を特定する必要がなくなります。
詳細については、「 ユーザーとデバイスをユーザー デバイス アフィニティとリンクする」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: ユーザー ID によってユーザーにデバイス アフィニティを追加する
PS XYZ:\>Add-CMDeviceAffinityToUser -UserName "Patti Fuller" -DeviceName "WestDivUpdates05"このコマンドは、Patti Fuller というユーザーの WestDivUpdates05 という名前のデバイスにアフィニティを追加します。
パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DeviceId
ID を使用してデバイスを指定します。
| 型: | Int32[] |
| Aliases: | DeviceIds |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DeviceName
名前を使用してデバイスを指定します。
| 型: | String[] |
| Aliases: | DeviceNames |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UserId
ID を使用してユーザーを指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UserName
デバイスに関連付けるユーザー名の配列を指定します。
| 型: | String[] |
| Aliases: | UniqueUserName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object