Skip to content

Add-DeviceGroupMember

SYNOPSIS

Adds a device to an existing device group

SYNTAX

FromPipeline

Add-DeviceGroupMember [[-DeviceGroup] <Object>] [-DeviceCategory] <String> [[-DeviceId] <String>]
 [[-Device] <Object>] [<CommonParameters>]

FromPath

Add-DeviceGroupMember [-DeviceCategory] <String> [-Path] <String> [[-DeviceId] <String>] [[-Device] <Object>]
 [<CommonParameters>]

DESCRIPTION

Adds a device (camera, microphone, speaker, input, output, metadata) to an existing device group.

EXAMPLES

Example 1

$group = Add-DeviceGroup -DeviceCategory Camera -Path /Parking/East; Select-Camera -RemoveDuplicates | Foreach-Object { $group |Add-DeviceGroupMember -DeviceCategory Camera -Device $_ }

Creates a device group if it doesn't exist, called "East" under the parent group "Parking". Then prompts the user to select one or more cameras to add to the group, and finally adds each selected camera to the device group.

PARAMETERS

-Device

Specifies a device object such as is returned from Get-Camera, Get-Microphone, Get-Speaker, Get-Input, Get-Output or Get-Metadata.

Type: Object
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeviceCategory

Specifies the device category of the device group to which the device should be added.

Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Camera, Microphone, Speaker, Metadata, Input, Output

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeviceGroup

Specifies the device group object to which a new member will be added.

Type: Object
Parameter Sets: FromPipeline
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-DeviceId

Specifies the device ID for the device to add to the device group. This is an alternative to supplying a device object using the Device parameter.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Path

Specifies the device group path in a unix-style format such as "/Parking/East" as an alternative to supplying the device group object in the DeviceGroup parameter.

Type: String
Parameter Sets: FromPath
Aliases:

Required: True
Position: 3
Default value: None
Accept pipeline input: False
Accept 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

System.Object

OUTPUTS

System.Object

NOTES

Online Help