Get-VmsSite¶
SYNOPSIS¶
Gets a VideoOS.Platform.Item
object representing a Milestone XProtect management server.
SYNTAX¶
DESCRIPTION¶
The Get-VmsSite
cmdlet can be used to identify which site is currently selected,
or which sites are available to be selected. When logged into a Milestone
Federated Hierarchy, many cmdlets only operate on the currently "selected" site
which will be the site that was directly logged in to using Connect-Vms
.
To view and modify the configuration of resources on a child site, you can pipe
the output from Get-VmsSite
to Select-VmsSite
.
REQUIREMENTS
- Requires VMS connection and will attempt to connect automatically
EXAMPLES¶
EXAMPLE 1¶
This command returns a [VideoOS.Platform.Item]
object representing the currently selected site.
EXAMPLE 2¶
This command lists all available sites in a Milestone Federated Hierarchy and works the same way as Get-VmsSite -Name *
.
Note that it will include child sites even if you did not login to them by using -IncludeChildSites
with Connect-Vms
.
EXAMPLE 3¶
This command command will return an object representing the site named "Site2". If no such site exists, it will return an error because there is no wildcard in the Name parameter.
EXAMPLE 4¶
This command gets all Items representing sites where the display name begins with "DR-". If no matching sites exist, no values are returned. Due to the presence of the wildcard character "*", there will be no error.
PARAMETERS¶
-ListAvailable¶
List all available sites in a Milestone Federated Hierarchy to choose from.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name¶
Specifies the display name of a site, with support for wildcards, used to filter the list of available sites.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 0
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.