Copy-LMDevicePropertyToDevice
Syntax
SourceDevice (Default)
Copy-LMDevicePropertyToDevice -SourceDeviceId <String> -TargetDeviceId <String[]> -PropertyNames <String[]> [-PassThru] [-ProgressAction <ActionPreference>] [<CommonParameters>]
SourceGroup
Copy-LMDevicePropertyToDevice -SourceGroupId <String> -TargetDeviceId <String[]> -PropertyNames <String[]> [-PassThru] [-ProgressAction <ActionPreference>] [<CommonParameters>]
Description
The Copy-LMDevicePropertyToDevice function copies specified properties from a source device to one or more target devices. The source device can be randomly selected from a group or explicitly specified. Properties are copied to the targets while preserving other existing device properties.
Examples
Example 1
Copy-LMDevicePropertyToDevice -SourceDeviceId 123 -TargetDeviceId 456 -PropertyNames "location","department"Copies the location and department properties from device 123 to device 456.
Example 2
Copy-LMDevicePropertyToDevice -SourceGroupId 789 -TargetDeviceId 456,457 -PropertyNames "location" -PassThruRandomly selects a device from group 789 and copies its location property to devices 456 and 457, returning the updated devices.
Parameters
-SourceDeviceId
The ID of the source device to copy properties from. This parameter is part of the “SourceDevice” parameter set.
Type: StringParameter Sets: SourceDeviceAliases:
Required: TruePosition: NamedDefault value: NoneAccept pipeline input: True (ByPropertyName)Accept wildcard characters: False
-SourceGroupId
The ID of the source group to randomly select a device from. This parameter is part of the “SourceGroup” parameter set.
Type: StringParameter Sets: SourceGroupAliases:
Required: TruePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
-TargetDeviceId
The ID of the target device(s) to copy properties to. Multiple device IDs can be specified.
Type: String[]Parameter Sets: (All)Aliases:
Required: TruePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
-PropertyNames
Array of property names to copy. These can be only be custom properties directly assigned to the device.
Type: String[]Parameter Sets: (All)Aliases:
Required: TruePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
-PassThru
If specified, returns the updated device objects.
Type: SwitchParameterParameter Sets: (All)Aliases:
Required: FalsePosition: NamedDefault value: FalseAccept pipeline input: FalseAccept wildcard characters: False
-ProgressAction
Fill ProgressAction Description
Type: ActionPreferenceParameter Sets: (All)Aliases: proga
Required: FalsePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
Outputs
Notes
Requires an active Logic Monitor session. Use Connect-LMAccount to log in before running this function.