PowerShell gebruiken om instellingen voor Het Windows-beheercentrum te beheren

Artikel
2025-02-20
Van toepassing op: ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Als u een grote organisatie hebt met meerdere Windows Admin Center-servers, kunt u PowerShell gebruiken om de lijst met verbindingen en extensies op meerdere servers tegelijk te configureren.

PowerShell gebruiken om uw verbindingen (met tags) te importeren of te exporteren

# 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-bestandsindeling voor het importeren van verbindingen

De indeling van het CSV-bestand begint met de volgende vier koppen, gevolgd door elke verbinding op een nieuwe regel.

name: de FQDN van de verbinding.
type: het verbindingstype. Gebruik een van de volgende tekenreeksen voor de standaardverbindingen die zijn opgenomen in het Windows-beheercentrum:

Verbindingstype Verbindingsreeks

Windows Server msft.sme.connection-type.server

Failovercluster msft.sme.connection-type.cluster
tags: door pijpen gescheiden tags.
groupId: de kolom voor gedeelde verbindingen. Gebruik de waarde global in deze kolom om een gedeelde verbinding te maken.

Verbindingstype	Verbindingsreeks
Windows Server	`msft.sme.connection-type.server`
Failovercluster	`msft.sme.connection-type.cluster`

Notitie

Het wijzigen van de gedeelde verbindingen is beperkt tot gatewaybeheerders. Elke gebruiker kan PowerShell gebruiken om de persoonlijke lijst met verbindingen te wijzigen.

Voorbeeld van EEN CSV-bestand voor het importeren van verbindingen

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

Notitie

Het CSV-bestand is hoofdlettergevoelig.

RDCMan-verbindingen importeren

Gebruik het volgende script om opgeslagen verbindingen te exporteren in RDCMan- naar een bestand. Vervolgens kunt u het bestand importeren in het Windows-beheercentrum en uw RDCMan-groeperingshiërarchie onderhouden met behulp van tags.

Kopieer en plak de volgende code in uw PowerShell-sessie:

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

Voer de volgende opdracht uit om een CSV-bestand te maken:
```
RdgToWacCsv -RDGfilepath "path\to\myRDCManfile.rdg"
```
Importeer het resulterende CSV-bestand in het Windows-beheercentrum. Tags in de lijst met verbindingen vertegenwoordigen uw RDCMan-groeperingshiërarchie.

Windows Admin Center-extensies beheren met 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"

Notitie

U moet de gatewaybeheerder zijn om extensies van het Windows-beheercentrum te wijzigen met PowerShell.

Delen via

PowerShell gebruiken om instellingen voor Het Windows-beheercentrum te beheren

PowerShell gebruiken om uw verbindingen (met tags) te importeren of te exporteren

CSV-bestandsindeling voor het importeren van verbindingen

Voorbeeld van EEN CSV-bestand voor het importeren van verbindingen

RDCMan-verbindingen importeren

Windows Admin Center-extensies beheren met PowerShell

Aanvullende verwijzingen

Feedback

Aanvullende resources