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