Connect-ManagementServer

SYNOPSIS

Se conecta a un servidor de gestión de VMS XProtect Milestone.

SYNTAX

NoLoginDialog

Connect-ManagementServer [[-ServerAddress] <Uri>] [[-Server] <String>] [-Port <Int32>]
 [[-Credential] <PSCredential>] [-BasicUser] [-SecureOnly] [-AcceptEula] [-IncludeChildSites] [-Force]
 [[-WcfProxyTimeoutSeconds] <Int32>] [<CommonParameters>]

ShowLoginDialog

Connect-ManagementServer [-AcceptEula] [-IncludeChildSites] [-Force] [-ShowDialog] [-DisableAutoLogin]
 [[-WcfProxyTimeoutSeconds] <Int32>] [<CommonParameters>]

DESCRIPTION

El cmdlet Connect-ManagementServer es el primer cmdlet que se usa cuando se trabaja con MilestonePSTools para explorar o modificar un VMS XProtect Milestone.

Los métodos de autenticación incluyen usuarios de Windows, Active Directory o usuarios básicos, y Milestone Federated Architecture es es compatible cuando se usa cualquier cosa además de la Autenticación básica. El estado de la sesión con el Servidor de gestión se mantendrá en segundo plano mientras dure la sesión de PowerShell o hasta que se utilice Disconnect-ManagementServer.

De forma predeterminada, este cmdlet solo se autenticará con el servidor de gestión proporcionado en el parámetro -Server. Si es necesario tener acceso a los sitios secundarios durante la misma sesión, debe proporcionar el switch -IncludeChildSites y usar el cmdlet Select-VmsSite para cambiar entre sitios

Cuando utilice MilestonePSTools de forma interactiva, puede optar por utilizar un cuadro de diálogo de inicio de sesión basado en GUI al incluir el parámetro de cambio -ShowDialog.

Al conectarse a un servidor de administración principal en una jerarquía de Arquitectura federada de Milestone, puede usar el modificador -IncludeChildSites, y se autenticará automáticamente con cada sitio secundario, de forma recursiva, en la jerarquía.

Nota: Si no proporciona un objeto Credencial, se utilizará el usuario de Windows actual para la autenticación automáticamente.

REQUIREMENTS

• Does not require a VMS connection

EXAMPLES

EXAMPLE 1

Connect-ManagementServer -ShowDialog -ErrorAction Stop

Get-VmsHardware

Disconnect-ManagementServer

Solicita al usuario con un diálogo familiar de inicio de sesión de Milestone que inicie sesión en el Servidor de administración. Con -ErrorAction Stop, una falla en la autenticación evitará que se ejecute el siguiente comando.

Luego, "Get-VmsHardware" devuelve información para todos los dispositivos de hardware en todos los servidores de grabación en el sitio actual.

Finalmente, Disconnect-ManagementServer cierra la sesión correctamente.

EXAMPLE 2

Connect-ManagementServer -ShowDialog -DisableAutoLogin

Solicita al usuario con un cuadro de diálogo de inicio de sesión familiar de Milestone que inicie sesión en el servidor de administración y evita el inicio de sesión automático en caso de que se haya utilizado anteriormente y no se desee ahora.

EXAMPLE 3

Connect-ManagementServer -Server mgtsrv1

Este comando se autentica con un servidor llamado mgtsrv1 donde el servidor está escuchando en el puerto HTTP 80 y usa el contexto de usuario actual de PowerShell.

Si ha abierto PowerShell normalmente, como su usuario actual de Windows, las credenciales utilizadas serán las de su usuario actual de Windows.

Si ha abierto PowerShell como un usuario diferente (shift-clic derecho, ejecutar como un usuario diferente), O está ejecutando su script como una tarea programada, el contexto de usuario será el de la cuenta de usuario que se usó para iniciar PowerShell sesión.

EXAMPLE 4

Connect-ManagementServer -Server mgtsrv1 -Credential (Get-Credential)

Este comando solicitará al usuario un nombre de usuario y contraseña, luego se autentica con un servidor llamado mgtsrv1 donde el servidor está escuchando en el puerto HTTP 80 usando la autenticación de Windows.

EXAMPLE 5

Connect-ManagementServer -Server mgtsrv1 -Credential (Get-Credential) -BasicUser

Este comando se autentica con un servidor llamado mgtsrv1 donde el servidor está escuchando en el puerto HTTPS 443, y autentica a un usuario básico usando las credenciales proporcionadas en la ventana emergente Get-Credential

Nota: Como "usuario básico", el usuario no tendrá acceso a los sitios secundarios en una arquitectura federada de Milestone y, por lo tanto, el modificador -IncludeChildSites no tendrá ningún efecto.

PARAMETERS

-AcceptEula

Reconozca que ha leído y acepta el acuerdo de licencia de usuario final para el paquete de SDK de MIP redistribuible. Este comando es necesario en el primer uso de Connect-ManagementServer para el usuario actual de Windows.

• Nota: un archivo de 0 bytes se coloca en %appdata%\MilestonePSTools\user-accept-eula.txt una vez que se ha aceptado el acuerdo. *

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 7
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-BasicUser

Utilice la autenticación de usuario básica de Milestone en lugar de Windows o Active Directory.

Type: SwitchParameter
Parameter Sets: NoLoginDialog
Aliases:

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

-Credential

Especifica una cuenta de usuario que tiene permiso para iniciar sesión en Milestone XProtect VMS Management Server. Puede ser un usuario básico de Windows, Active Directory o Milestone.

• Cuando se omite, la autenticación procederá con el usuario actual de Windows.
• Al especificar credenciales para un usuario básico, también debe proporcionar el parámetro -BasicUser.

Type: PSCredential
Parameter Sets: NoLoginDialog
Aliases:

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

-DisableAutoLogin

Deshabilitado y evita el inicio de sesión automático cuando se muestra el cuadro de diálogo de inicio de sesión.

Type: SwitchParameter
Parameter Sets: ShowLoginDialog
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Force

Fuerza un `"Disconnect-ManagementServer" antes de conectarse al Management Server especificado o mostrar el cuadro de diálogo de inicio de sesión.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 9
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-IncludeChildSites

Después de una autenticación exitosa con el Management Server especificado, la autenticación debe realizarse en todos los sitios secundarios en una jerarquía de Milestone Federated Architecture.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 8
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Port

Obsoleto: utilice ServerAddress. Especifica, como un número entero entre 1-65535, el puerto HTTP del servidor de administración. El valor predeterminado es 80.

Nota: cuando utilice la autenticación básica y un puerto HTTP personalizado en el servidor de administración, deje este valor solo. MIP SDK utilizará automáticamente HTTPS en el puerto 443.

Type: Int32
Parameter Sets: NoLoginDialog
Aliases:

Required: False
Position: Named
Default value: 80
Accept pipeline input: False
Accept wildcard characters: False

-SecureOnly

Especifica que se requiere una conexión HTTPS para una autenticación exitosa.

Nota: Requiere XProtect VMS versiones 2021 R1 y posteriores.

Type: SwitchParameter
Parameter Sets: NoLoginDialog
Aliases:

Required: False
Position: 6
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Server

Obsoleto: utilice ServerAddress. Especifica la dirección del Milestone XProtect VMS Management Server como IP, nombre de host o FQDN.

Type: String
Parameter Sets: NoLoginDialog
Aliases:

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

-ServerAddress

Especifica la dirección del servidor HTTP o HTTPS del servidor de administración Milestone XProtect VMS.

Type: Uri
Parameter Sets: NoLoginDialog
Aliases:

Required: False
Position: 99
Default value: http://localhost/
Accept pipeline input: False
Accept wildcard characters: False

-ShowDialog

Muestra un cuadro de diálogo de inicio de sesión tipico de Milestone. El cuadro de diálogo admite "Recordar contraseña" e "Inicio de sesión automático".

REQUIREMENTS

• Requires an interactive PowerShell session.

Type: SwitchParameter
Parameter Sets: ShowLoginDialog
Aliases:

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

-WcfProxyTimeoutSeconds

Especifica, como un valor entero, el número máximo de segundos inactivos antes de que un canal de Windows Communication Foundation (WCF), utilizado para comunicarse con las API de Milestone XProtect, se considere agotado.

La API de configuración, utilizada directamente por comandos como Get-ConfigurationItem eInvoke-Method, y algunas veces indirectamente por otros comandos en el módulo, usa WCF. Hay otras API a las que puede acceder, como a través del proxy WCF devuelto por Get-IServerCommandService, que también están configuradas para usar el tiempo de espera especificado aquí.

La configuración predeterminada es adecuada para los patrones de uso más comunes de este módulo.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 10
Default value: 300
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

Connect-ManagementServer no acepta entrada de canalización.

OUTPUTS

None

A menos que ocurra un error, Connect-ManagementServer no genera salida.

NOTES

Cuando se usa -ShowDialog, el SDK de MIP almacena el historial de inicio de sesión enC:\Users\jh\AppData\Roaming\MIPSDK\LoginHistory.xml.

RELATED LINKS

Online Help