Använda PowerShell för att hantera Inställningar för Administrationscenter för Windows

Artikel
02/16/2025
Gäller för:

✅ Windows Admin Center, ✅ Windows Admin Center Preview

Om du har en stor organisation med flera Windows Admin Center-servrar kan du använda PowerShell för att konfigurera listan över anslutningar och tillägg på flera servrar i taget.

Använd PowerShell för att importera eller exportera dina anslutningar (med taggar)

# 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

CSV-filformat för import av anslutningar

Formatet för CSV-filen börjar med följande fyra rubriker, följt av varje anslutning på en ny rad.

name: FQDN för anslutningen.
type: Anslutningstypen. Använd någon av följande strängar för de standardanslutningar som ingår i Administrationscenter för Windows:

Anslutningstyp Anslutningssträng

Windows Server msft.sme.connection-type.server

Failover-kluster msft.sme.connection-type.cluster
tags: Pipe-avgränsade taggar.
groupId: Kolumnen för delade anslutningar. Använd värdet global i den här kolumnen för att skapa en delad anslutning.

Anslutningstyp	Anslutningssträng
Windows Server	`msft.sme.connection-type.server`
Failover-kluster	`msft.sme.connection-type.cluster`

Notera

Att ändra de delade anslutningarna är begränsat till gatewayadministratörer. Alla användare kan använda PowerShell för att ändra sin personliga anslutningslista.

Exempel på CSV-fil för att importera anslutningar

"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"

Anteckning

CSV-filen är skiftlägeskänslig.

Importera RDCMan-anslutningar

Använd följande skript för att exportera sparade anslutningar i RDCMan till en fil. Du kan sedan importera filen till Administrationscenter för Windows och underhålla din RDCMan-grupperingshierarki med hjälp av taggar.

Kopiera och klistra in följande kod i PowerShell-sessionen:

#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"
}

Kör följande kommando för att skapa en CSV-fil:

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

Importera den resulterande CSV-filen till Windows Admin Center. Taggar i anslutningslistan representerar din RDCMan-grupperingshierarki.

Hantera Windows Admin Center-tillägg med 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"

Observera

Du måste vara gatewayadministratör för att kunna ändra Windows Admin Center-tillägg med PowerShell.

Dela via

Använda PowerShell för att hantera Inställningar för Administrationscenter för Windows

Använd PowerShell för att importera eller exportera dina anslutningar (med taggar)

CSV-filformat för import av anslutningar

Exempel på CSV-fil för att importera anslutningar

Importera RDCMan-anslutningar

Hantera Windows Admin Center-tillägg med PowerShell

Ytterligare referenser

Feedback

Ytterligare resurser