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.