Bagikan melalui

Menggunakan PowerShell untuk mengelola pengaturan Pusat Admin Windows

  • Artikel
  • Berlaku untuk:
    ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Jika Anda memiliki organisasi besar dengan beberapa server Pusat Admin Windows, Anda dapat menggunakan PowerShell untuk mengonfigurasi daftar koneksi dan ekstensi di beberapa server sekaligus.

Menggunakan PowerShell untuk mengimpor atau mengekspor koneksi Anda (dengan tag)

# 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

Format file CSV untuk mengimpor koneksi

Format file CSV dimulai dengan empat judul berikut, diikuti oleh setiap koneksi pada baris baru.

  • name: FQDN koneksi.

  • type: Jenis koneksi. Untuk koneksi default yang disertakan dengan Pusat Admin Windows, gunakan salah satu string berikut:

    Jenis koneksi String koneksi
    Windows Server msft.sme.connection-type.server
    Kluster failover msft.sme.connection-type.cluster

  • tags: Tag yang dipisahkan pipa.

  • groupId: Kolom untuk koneksi bersama. Gunakan nilai global di kolom ini untuk membuat koneksi bersama.

Nota

Mengubah koneksi bersama terbatas pada administrator gateway. Setiap pengguna dapat menggunakan PowerShell untuk mengubah daftar koneksi pribadi mereka.

Contoh file CSV untuk mengimpor koneksi

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

Nota

File CSV sensitif terhadap huruf besar/kecil.

Mengimpor koneksi RDCMan

Gunakan skrip berikut untuk mengekspor koneksi tersimpan di RDCMan ke file. Anda kemudian dapat mengimpor file ke Pusat Admin Windows dan mempertahankan hierarki pengelompokan RDCMan Anda dengan menggunakan tag.

  1. Salin dan tempel kode berikut ke sesi PowerShell Anda:

    #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. Untuk membuat file CSV, jalankan perintah berikut:

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

  3. Impor file CSV yang dihasilkan ke Pusat Admin Windows. Tag dalam daftar koneksi mewakili hierarki pengelompokan RDCMan Anda.

Mengelola ekstensi Pusat Admin Windows dengan 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"

Nota

Anda harus menjadi administrator gateway untuk mengubah ekstensi Pusat Admin Windows dengan PowerShell.

Referensi Tambahan