Skip to content

Export-LMDeviceConfigBackup

Syntax

Device (Default)

Terminal window
Export-LMDeviceConfigBackup -DeviceId <Int32> [-InstanceNameFilter <Regex>] [-ConfigSourceNameFilter <Regex>]
[-Path <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

DeviceGroup

Terminal window
Export-LMDeviceConfigBackup -DeviceGroupId <Int32> [-InstanceNameFilter <Regex>]
[-ConfigSourceNameFilter <Regex>] [-Path <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

The Export-LMDeviceConfigBackup function exports the latest version of device configurations for specified devices. It can export configs from either a single device or all devices in a device group.

Examples

Example 1

Terminal window
#Export configurations from a device group
Export-LMDeviceConfigBackup -DeviceGroupId 2 -Path "export-report.csv"

Example 2

Terminal window
#Export configurations from a single device
Export-LMDeviceConfigBackup -DeviceId 1 -Path "export-report.csv"

Parameters

-DeviceGroupId

The ID of the device group to export configurations from. This parameter is mandatory when using the DeviceGroup parameter set.

Type: Int32
Parameter Sets: DeviceGroup
Aliases:
Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-DeviceId

The ID of the device to export configurations from. This parameter is mandatory when using the Device parameter set.

Type: Int32
Parameter Sets: Device
Aliases:
Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-InstanceNameFilter

A regex filter to use for filtering Instance names. Defaults to “running|current|PaloAlto”.

Type: Regex
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: [rR]unning|[cC]urrent|[pP]aloAlto
Accept pipeline input: False
Accept wildcard characters: False

-ConfigSourceNameFilter

A regex filter to use for filtering ConfigSource names. Defaults to ”.*”.

Type: Regex
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: .*
Accept pipeline input: False
Accept wildcard characters: False

-Path

The file path where the CSV backup will be exported to.

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction

Fill ProgressAction Description

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga
Required: False
Position: Named
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. You cannot pipe objects to this command.

Outputs

Returns an array of device configuration objects if successful.

Notes

You must run Connect-LMAccount before running this command.