Import-CMUserDeviceAffinity

モジュール:

ConfigurationManager

ユーザーとデバイスのアフィニティを含むファイルを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 データベース内のリソースとして既に存在している必要があります。 存在しない場合、インポートは失敗します。

注:

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

例

例 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 ファイルを指定します。 各ユーザーとデバイスのペアは、コンマで区切られた個別の行に配置する必要があります。 ドメイン>\ユーザー名、<デバイス NetBIOS 名>の形式<を使用します><。

型:	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

関連リンク

• Get-CMUserDeviceAffinity