Exemplo de script do PowerShell usando a API REST do CloudLink

Resumen: Este arquivo é apenas para fins educacionais/informativos. Pode ser usado como referência ao escrever scripts de automação do CloudLink com a linguagem de script do PowerShell. A Dell não assume nenhuma responsabilidade por esse arquivo ser executado como um script do PowerShell no ambiente do Cliente Dell. O script mostra uma maneira de listar as máquinas registradas no Cloudlink e suas unidades a partir de um script do PowerShell usando chamadas RestAPI do Cloudlink. O script não altera o estado de nenhum sistema, apenas exibe informações. O acesso ao nó do Cloudlink (indicado pelo endereço IP) é concedido com as credenciais de um usuário do Cloudlink do tipo 'client'. ...

Este artículo se aplica a Este artículo no se aplica a Este artículo no está vinculado a ningún producto específico. No se identifican todas las versiones del producto en este artículo.

Síntomas

O script pode ser usado para automatizar as operações do CloudLink. Neste exemplo, o script lista as máquinas registradas no Cloudlink Center.

 

Causa

O script pode ser útil para clientes que têm vários Cloudlink Centers ou que desejam gerenciar o Cloudlink Center usando um script do PowerShell.

 

Resolución

# Copyright Dell © 2021, 2022
# Este arquivo é apenas para fins educacionais/informativos.
# Pode ser usado como referência ao escrever scripts de automação do CloudLink com a linguagem de script do PowerShell.
# A Dell não assume nenhuma responsabilidade por esse arquivo ser executado como um script do PowerShell no ambiente do Cliente Dell.

# O script mostra uma maneira de listar as máquinas registradas com o Cloudlink e suas unidades a partir de um script do PowerShell usando chamadas RestAPI do Cloudlink.
# O script não altera o estado de nenhum sistema, apenas exibe informações.
# O acesso ao nó do Cloudlink (indicado pelo endereço IP) é concedido com as credenciais de um usuário do Cloudlink do tipo 'client'.

# A parte a seguir é zombar da validação do certificado, o certificado é sempre válido.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
if (-not ([System.Management.Automation.PSTypeName]'ServerCertificateValidationCallback').Type)
{
$certCallback = @"
    using System;
    using System.Net;
    using System.Net.Security;
    using System.Security.Cryptography.X509Certificates;
    public class ServerCertificateValidationCallback
    {
        public static void Ignore()
        {
            if(ServicePointManager.ServerCertificateValidationCallback ==null)
            {
                ServicePointManager.ServerCertificateValidationCallback +=
                    delegate
                    (
                        Object obj,
                        X509Certificate certificate,
                        X509Chain chain,
                        SslPolicyErrors errors
                    )
                    {
                        return true;
                    };
            }
        }
    }
"@
    Add-Type $certCallback
 }
[ServerCertificateValidationCallback]::Ignore()


$server='<cloudlink node ip>'
$client_id='<client id>'
$client_secret='<client secret>'

if ($args[0] -ne $null)
{  $server=$args[0] }

if ($args[1] -ne $null)
{  $client_id=$args[1] }

if ($args[2] -ne $null)
{  $client_secret=$args[2] }



$serverport=$server+":443"

Write-Output  "parameters: server=$server, client_id=$client_id, client_secret=$client_secret"

$responsee=Invoke-RestMethod -Uri "https://$server/cloudlink/oauth/token?grant_type=client_credentials&client_id=$client_id&client_secret=$client_secret&scope=all" -Method Get -TimeoutSec 1800
Write-Output "The response received:"
Write-Output "$responsee"



if($responsee.access_token)
{
  $mytoken=$responsee.access_token

  $Type = "application/json"
  $resolveSessionHeader = @{'Authorization' = "Bearer $mytoken"}

# Consulta para a lista de máquinas

  $machine_list_query='https://$serverport/cloudlink/rest/securevm'
  $machine_list=Invoke-WebRequest -Method Get -Uri $machine_list_query -Headers $resolveSessionHeader -ContentType $Type

# Listar as máquinas no console.

  Write-Host "Machine list:" -ForegroundColor Yellow
  $machine_list_txt = $machine_list | ConvertFrom-Json
  $machine_list_txt | FT

#For cada máquina, liste as unidades.

  foreach ($machine in $machine_list_txt)
  {
    $drives_list = $($machine.resources)
    Write-Host "$($machine.name) $($machine.ip_address) ($($machine.os_name)) group $($machine.group)" -ForegroundColor Yellow
    $drives_list | FT
  }
}

 

Productos afectados

CloudLink SecureVM, CloudLink
Propiedades del artículo
Número del artículo: 000202396
Tipo de artículo: Solution
Última modificación: 09 jun 2026
Versión:  7
Encuentre respuestas a sus preguntas de otros usuarios de Dell
Servicios de soporte
Compruebe si el dispositivo está cubierto por los servicios de soporte.