Skip to content

Add-DeviceGroup

SYNOPSIS

Adds a new device group and returns the CameraGroup object representing the new group

SYNTAX

Add-DeviceGroup [-DeviceCategory] <String> [-Path] <String> [<CommonParameters>]

DESCRIPTION

Use this function to create a new device group for cameras, microphones, and other devices. These device groups can be used in rules, for navigation in client applications, and for applying settings to devices in bulk.

This function accepts a "unix-style" path where each node of the path is delimited by a forward slash, and new device groups will be created recursively.

EXAMPLES

Example 1

$cameraGroup = Add-DeviceGroup -DeviceCategory Camera -Path /Parking/East

Creates a camera group at the root of the camera group tree named "Parking". Then creates a sub-group named "East". If any group in the path already exists, it will be used and no new group will be created. The value returned will be a CameraGroup object named "East", representing the last node of the camera group path provided.

PARAMETERS

-DeviceCategory

Specifies the device category under which to create the device group.

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

-Path

Specifies a unix-style path in the format /FirstLevel/SecondLevel/ThirdLevel.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
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

None

OUTPUTS

System.Object

NOTES

Online Help