Import-CMUserDeviceAffinity
ユーザーとデバイスのアフィニティを含むファイルを Configuration Manager にインポートします。
構文
Import-CMUserDeviceAffinity
[-EnableColumnHeading <Boolean>]
-FileName <String>
[-MappingOrder <Mapping[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Import-CMUserDeviceAffinity コマンドレットは、ユーザーとデバイスのアフィニティを含むファイルを Configuration Manager にインポートします。 Configuration Manager のユーザー デバイス アフィニティは、ユーザーを 1 つ以上の指定されたデバイスに関連付ける方法です。
FileName パラメーターで指定するファイルに一覧表示されているデバイスは、Configuration Manager データベースのリソースとして既に存在している必要があります。 存在しない場合、インポートは失敗します。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: ユーザー デバイス アフィニティをインポートする
PS XYZ:\>Import-CMUserDeviceAffinity -FileName "Remote_Users.csv" -EnableColumnHeadings $True
このコマンドは、Remote_Users.csv という名前のファイルにユーザー デバイス アフィニティをインポートします。 EnableColumnHeadings パラメーターは、参照目的でインポート ファイルに列見出しがあることを指定します。
パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-EnableColumnHeading
型: | Boolean |
Aliases: | EnableColumnHeadings |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FileName
アフィニティを作成するユーザーとデバイスの一覧を含む .csv ファイルを指定します。 各ユーザーとデバイスのペアは、コンマで区切られた個別の行に配置する必要があります。 形式 <Domain>\<user name>,<device NetBIOS name> を使用します。
型: | String |
Aliases: | FilePath, ImportFilePath, Path |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MappingOrder
型: | Mapping[] |
Aliases: | MappingOrders |
指定可能な値: | Users, Devices, Ignored |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object