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

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
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

-EnableColumnHeading

Type:	Boolean
Aliases:	EnableColumnHeadings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FileName

アフィニティを作成するユーザーとデバイスの一覧を含む.csv ファイルを指定します。 各ユーザーとデバイスのペアは、コンマで区切られた個別の行に配置する必要があります。 ドメイン>\ユーザー名、<デバイス NetBIOS 名>の形式<を使用します><。

Type:	String
Aliases:	FilePath, ImportFilePath, Path
Position:	Named
Default value:	None
Required:	True
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

-MappingOrder

Type:	Mapping[]
Aliases:	MappingOrders
Accepted values:	Users, Devices, Ignored
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

関連リンク

• Get-CMUserDeviceAffinity