PSProxmox/Cmdlets/DisconnectProxmoxServerCmdlet.cs

using System;
using System.Management.Automation;
using PSProxmox.Session;

namespace PSProxmox.Cmdlets
{
    /// <summary>
    /// <para type="synopsis">Disconnects from a Proxmox VE server.</para>
    /// <para type="description">The Disconnect-ProxmoxServer cmdlet terminates a connection to a Proxmox VE server.</para>
    /// <example>
    ///   <para>Disconnect from a Proxmox VE server</para>
    ///   <code>Disconnect-ProxmoxServer -Connection $connection</code>
    /// </example>
    /// </summary>
    [Cmdlet(VerbsCommunications.Disconnect, "ProxmoxServer")]
    public class DisconnectProxmoxServerCmdlet : PSCmdlet
    {
        /// <summary>
        /// <para type="description">The connection to disconnect from.</para>
        /// </summary>
        [Parameter(Mandatory = true, Position = 0, ValueFromPipeline = true)]
        public ProxmoxConnection Connection { get; set; }

        /// <summary>
        /// Processes the cmdlet.
        /// </summary>
        protected override void ProcessRecord()
        {
            try
            {
                if (Connection == null)
                {
                    throw new PSArgumentNullException(nameof(Connection));
                }

                ProxmoxSession.Logout(Connection, this);
                WriteVerbose($"Disconnected from {Connection.Server}");
            }
            catch (Exception ex)
            {
                WriteError(new ErrorRecord(ex, "DisconnectProxmoxServerError", ErrorCategory.ConnectionError, Connection));
            }
        }
    }
}