Usar o PowerShell para gerenciar as configurações do Windows Admin Center

Se você tiver uma organização grande com vários servidores do Windows Admin Center, poderá usar o PowerShell para configurar a lista de conexões e extensões em vários servidores de cada vez.

Use o PowerShell para importar ou exportar suas conexões (com marcas)

# Load the module
Import-Module "$env:ProgramFiles\windows admin center\PowerShell\Modules\ConnectionTools"
# Available cmdlets: Export-Connection, Import-Connection

# Export connections (including tags) to a .csv file
Export-Connection "https://wac.contoso.com" -fileName "WAC-connections.csv"
# Import connections (including tags) from a .csv file
Import-Connection "https://wac.contoso.com" -fileName "WAC-connections.csv"
# Import connections (including tags) from .csv files, and remove any connections that are not explicitly in the imported file by using the -prune switch parameter 
Import-Connection "https://wac.contoso.com" -fileName "WAC-connections.csv" -prune

Formato de arquivo CSV para importação de conexões

O formato do arquivo CSV começa com os quatro títulos a seguir, seguidos por cada conexão em uma nova linha.

• name: o FQDN da conexão.

• type: o tipo de conexão. Para as conexões padrão incluídas no Windows Admin Center, use uma das seguintes cadeias de caracteres:

  Tipo de conexão	Cadeia de conexão
  Windows Server	msft.sme.connection-type.server
  Cluster de failover	msft.sme.connection-type.cluster

• tags: tags separadas por barra vertical.

• groupId: a coluna para conexões compartilhadas. Use o valor global nesta coluna para fazer uma conexão compartilhada.

Exemplo de arquivo CSV para importar conexões

"name","type","tags","groupId"
"myServer.contoso.com","msft.sme.connection-type.server","hyperv"
"myDesktop.contoso.com","msft.sme.connection-type.windows-server","hyperv"
"teamcluster.contoso.com","msft.sme.connection-type.cluster","legacyCluster|WS2016","global"
"myHCIcluster.contoso.com,"msft.sme.connection-type.cluster","myHCIcluster|hyperv|JIT|WS2019"
"teamclusterNode.contoso.com","msft.sme.connection-type.server","legacyCluster|WS2016","global"
"myHCIclusterNode.contoso.com","msft.sme.connection-type.server","myHCIcluster|hyperv|JIT|WS2019"

Importar conexões RDCMan

Use o script a seguir para exportar conexões salvas em RDCMan para um arquivo. Em seguida, você pode importar o arquivo para o Windows Admin Center e manter sua hierarquia de agrupamento RDCMan usando marcas.

1. Copie e cole o seguinte código em sua sessão do PowerShell:

   #Helper function for RdgToWacCsv
   function AddServers {
    param (
    [Parameter(Mandatory = $true)]
    [Xml.XmlLinkedNode]
    $node,
    [Parameter()]
    [String[]]
    $tags,
    [Parameter(Mandatory = $true)]
    [String]
    $csvPath
    )
    if ($node.LocalName -eq 'server') {
        $serverName = $node.properties.name
        $tagString = $tags -join "|"
        Add-Content -Path $csvPath -Value ('"'+ $serverName + '","msft.sme.connection-type.server","'+ $tagString +'"')
    } 
    elseif ($node.LocalName -eq 'group' -or $node.LocalName -eq 'file') {
        $groupName = $node.properties.name
        $tags+=$groupName
        $currNode = $node.properties.NextSibling
        while ($currNode) {
            AddServers -node $currNode -tags $tags -csvPath $csvPath
            $currNode = $currNode.NextSibling
        }
    } 
    else {
        # Node type isn't relevant to tagging or adding connections in Windows Admin Center
    }
    return
   }
   
   <#
   .SYNOPSIS
   Convert an .rdg file from Remote Desktop Connection Manager into a .csv that can be imported into Windows Admin Center, maintaining groups via server tags. This will not modify the existing .rdg file and will create a new .csv file
   
    .DESCRIPTION
    This converts an .rdg file into a .csv that can be imported into Windows Admin Center.
   
    .PARAMETER RDGfilepath
    The path of the .rdg file to be converted. This file will not be modified, only read.
   
    .PARAMETER CSVdirectory
    Optional. The directory you want to export the new .csv file. If it's not provided, the new file is created in the same directory as the .rdg file.
   
    .EXAMPLE
    C:\PS> RdgToWacCsv -RDGfilepath "rdcmangroup.rdg"
    #>
   function RdgToWacCsv {
    param(
        [Parameter(Mandatory = $true)]
        [String]
        $RDGfilepath,
        [Parameter(Mandatory = $false)]
        [String]
        $CSVdirectory
    )
    [xml]$RDGfile = Get-Content -Path $RDGfilepath
    $node = $RDGfile.RDCMan.file
    if (!$CSVdirectory){
        $csvPath = [System.IO.Path]::GetDirectoryName($RDGfilepath) + [System.IO.Path]::GetFileNameWithoutExtension($RDGfilepath) + "_WAC.csv"
    } else {
        $csvPath = $CSVdirectory + [System.IO.Path]::GetFileNameWithoutExtension($RDGfilepath) + "_WAC.csv"
    }
    New-item -Path $csvPath
    Add-Content -Path $csvPath -Value '"name","type","tags"'
    AddServers -node $node -csvPath $csvPath
    Write-Host "Converted $RDGfilepath `nOutput: $csvPath"
   }
   

2. Para criar um arquivo CSV, execute o seguinte comando:

   RdgToWacCsv -RDGfilepath "path\to\myRDCManfile.rdg"
   

3. Importe o arquivo CSV resultante para o Windows Admin Center. As marcas na lista de conexões representam sua hierarquia de agrupamento RDCMan.

Gerenciar extensões do Windows Admin Center com o PowerShell

# Add the module to the current session
Import-Module "$env:ProgramFiles\windows admin center\PowerShell\Modules\ExtensionTools"
# Available cmdlets: Get-Feed, Add-Feed, Remove-Feed, Get-Extension, Install-Extension, Uninstall-Extension, Update-Extension

# List feeds
Get-Feed "https://wac.contoso.com"

# Add a new extension feed
Add-Feed -GatewayEndpoint "https://wac.contoso.com" -Feed "\\WAC\our-private-extensions"

# Remove an extension feed
Remove-Feed -GatewayEndpoint "https://wac.contoso.com" -Feed "\\WAC\our-private-extensions"

# List all extensions
Get-Extension "https://wac.contoso.com"

# Install an extension (locate the latest version from all feeds and install it)
Install-Extension -GatewayEndpoint "https://wac.contoso.com" "msft.sme.containers"

# Install an extension (latest version from a specific feed, if the feed is not present, it will be added)
Install-Extension -GatewayEndpoint "https://wac.contoso.com" "msft.sme.containers" -Feed "https://aka.ms/sme-extension-feed"

# Install an extension (install a specific version)
Install-Extension "https://wac.contoso.com" "msft.sme.certificate-manager" "0.133.0"

# Uninstall-Extension
Uninstall-Extension "https://wac.contoso.com" "msft.sme.containers"

# Update-Extension
Update-Extension "https://wac.contoso.com" "msft.sme.containers"

Referências adicionais

• Implantar um gateway do Windows Admin Center altamente disponível em um cluster
• implantar um gateway do Windows Admin Center no Azure usando o Cloud Shell