MDT Windows PowerShell Cmdlet

除了 Deployment Workbench 之外,還可以使用 Windows PowerShell Cmdlet 管理 MDT 部署共用。 MDT Windows PowerShell Cmdlet 包含在 MDT 安裝中隨附的 Windows PowerShell 嵌入式管理單元 Microsoft.BDD.PSSnapIn。

MDT Cmdlet 必須從載入 MDT Windows PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行。 如需有關如何啟動已載入 MDT Windows PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

表 7 列出 MDT Windows PowerShell Cmdlet,並提供每個 Cmdlet 的簡短描述。 每個 Cmdlet 都會在後續章節中進一步詳細討論。

表格 7 MDT Windows PowerShell Cmdlet

指令程式 描述
Add-MDTPersistentDrive 將部署共用新增至可使用 Restore-MDTPersistentDrive Cmdlet 還原的 MDT 保存磁碟機清單。
Disable-MDTMonitorService 停用 MDT 監視服務。
Enable-MDTMonitorService 啟用 MDT 監視服務。
Get-MDTDeploymentShareStatistics 顯示部署共用的統計資料,包括部署共用中每個主要資料夾的實體數目。
Get-MDTMonitorData 顯示針對一或多個受監視的 MTD 部署所收集的 MDT 監視資訊。
Get-MDTOperatingSystemCatalog 傳回特定作業系統的作業系統目錄。 如果作業系統型錄不存在或已過期,則會重新產生作業系統型錄。
Get-MDTPersistentDrive 顯示可使用 Restore-MDTPersistentDrive cmdlet 還原的部署共用清單。
Import-MDTApplication 將應用程式匯入部署共用。
Import-MDTDriver 將一或多個裝置驅動程式匯入部署共用。
Import-MDTOperatingSystem 將一或多個作業系統匯入部署共用。
Import-MDTPackage 將一或多個作業系統套件匯入部署共用。
Import-MDTTaskSequence 將工作順序匯入部署共用。
New-MDTDatabase 建立或升級與部署共用相關聯的 MDT DB 資料庫。
Remove-MDTMonitorData 從部署共用中收集的 MDT 監視資料移除一或多個 MDT 監視資料項目。
Remove-MDTPersistentDrive 從可使用 Restore-MDTPersistentDrive Cmdlet 還原的 MDT 保存 Windows PowerShell 磁碟機清單中移除部署共用。
Restore-MDTPersistentDrive 為 MDT 保存的 Windows PowerShell 磁碟機清單中的每個部署共用建立 Windows PowerShell 磁碟機。
Set-MDTMonitorData 在部署共用中收集的 MDT 監視資料中,建立新的或更新現有的 MDT 監視資料項目。
Test-MDTDeploymentShare 驗證部署共用的完整性。
Test-MDTMonitorData 確認 MDT 監視服務已正確設定並執行中。
Update-MDTDatabaseSchema 匯報 MDT 資料庫結構描述。
Update-MDTDeploymentShare 匯報部署共用。
Update-MDTLinkedDS 將部署共用中的內容複寫到連結的部署共用。
Update-MDTMedia 將部署共用的內容複寫到部署媒體資料夾。

Add-MDTPersistentDrive

本節說明 Add-MDTPersistentDriveWindows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Add-MDTPersistentDrive [-Name] <String> [[-InputObject] <PSObject>] [<CommonParameters>]

描述

這個 Cmdlet 會將使用 MDTProvider 建立的現有 Windows PowerShell 磁碟機,新增至使用 Restore-MDTPersistentDrive Cmdlet 保存在 Deployment Workbench 或 Windows PowerShell 工作階段中的磁碟機清單。 當您在 Deployment Workbench 中建立或開啟部署共用時,呼叫此 Cmdlet。

注意事項

保存的 MDTProvider 磁碟機清單會根據使用者設定檔中的每個使用者進行維護。

您可以使用 Get-MDTPersistentDrive Cmdlet 來顯示保存的 MDTProvider 磁碟機清單。

參數

本小節提供可與 Add-MDTPersistentDriveWindows Cmdlet 搭配使用的各種參數的相關資訊。

-Name <字串>

指定使用 MDT 提供者建立的 Windows PowerShell 磁碟機名稱,並對應至現有的部署共用。 名稱是使用 New-PSDrive Cmdlet 並在 PSProvider 參數中指定 MDTProvider 所建立的。

如需如何使用 MDTProvider 建立新的 Windows PowerShell 磁碟機,以及如何使用 Windows PowerShell 建立部署共用的詳細資訊,請參閱 MDT 文件《Microsoft 部署工具組範例指南》中的「使用 Windows PowerShell 建立部署共用」一節。

參數 值
Required? True
位置? 2 和 已命名
預設值 無
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

-InputObject <PSObject>

這個參數會指定在此程序中稍早建立的 Windows PowerShell 磁碟機物件。 輸入 PSObject 物件,例如由 New-PSDrive Cmdlet 產生的物件。

參數 值
Required? False
位置? 3 和 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會輸出 PSObject 類型物件,表示 Windows PowerShell 磁碟機物件已被新增至保存磁碟機清單。

如果包含 Verbose common 參數,此 Cmdlet 也會輸出字串類型物件。

範例 1

Add-MDTPersistentDrive -Name DS001

描述

本範例會將 Windows PowerShell 磁碟機名稱為 DS001 的部署共用新增至保存磁碟機清單。

範例 2

$MDTPSDrive = New-PSDrive -Name "DS001" -PSProvider "MDTProvider" -Root "C:\DeploymentShare$" -Description "MDT Deployment Share" -NetworkPath \\WDG-MDT-01\DeploymentShare$ -Verbose
Add-MDTPersistentDrive -InputObject $MDTPSDrive

描述

本範例會使用 $MDTPSDrive 變數將 New-PSDrive Cmdlet 所建立的Windows PowerShell磁碟機名稱 DS001 新增至保存的 MDT 磁碟機清單。

範例 3

New-PSDrive -Name "DS001" -PSProvider "MDTProvider" -Root "C:\DeploymentShare$" -Description "MDT Deployment Share" -NetworkPath \\WDG-MDT-01\DeploymentShare$ -Verbose | Add-MDTPersistentDrive -Verbose

描述

此範例會將新建立的 Windows PowerShell 磁碟機物件管道傳送至 Add-MDTPersistentDrive Cmdlet,藉以將 New-PSDrive Cmdlet 所建立的 Windows PowerShell 磁碟機名稱 DS001 新增至保存的 MDT 磁碟機清單。

Disable-MDTMonitorService

本節說明 Disable-MDTMonitorService Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Disable-MDTMonitorService [<CommonParameters>]

描述

此 Cmdlet 會停用在安裝 MDT 的電腦上執行的 MDT 監視服務。 MDT 監視服務會收集可顯示的監視資訊:

  • 在部署工作台中的部署共用的 [監視] 節點中

  • 使用 Get-MDTMonitorData cmdlet

    之後可以使用 Enable-MDTMonitorService 來啟用 MDT 監視服務。

    如需 MDT 監視服務的詳細資訊,請參閱 MDT 文件中的「監視 MDT 部署」一節, 使用 Microsoft 部署工具組。

參數

本小節提供可與 Disable-MDTMonitorService Cmdlet 搭配使用的各種參數的相關資訊。

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取:

Get-Help about_CommonParameters

輸出

如果包含詳細通用參數,此 Cmdlet 會輸出字串類型物件;否則不會產生任何輸出。

範例 1

Disable-MDTMonitorService

描述

此範例會停用 MDT 監視服務。

Enable-MDTMonitorService

本節說明 Enable-MDTMonitorService Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Enable-MDTMonitorService [-EventPort] <Int32> [-DataPort] <Int32> [<CommonParameters>]

描述

此 Cmdlet 會啟用 MDT 監視服務,該服務會在安裝 MDT 的電腦上執行。 MDT 監視服務會收集可顯示的監視資訊:

  • 在部署工作台中的部署共用的 [監視] 節點中。

  • 使用 Get-MDTMonitorData cmdlet

    您可以使用 Disable-MDTMonitorService 停用 MDT 監視服務。

    如需 MDT 監視服務的詳細資訊,請參閱 MDT 文件中的「監視 MDT 部署」一節, 使用 Microsoft 部署工具組。

參數

本小節提供可與 Enable-MDTMonitorService Cmdlet 搭配使用的各種參數的相關資訊。

-EventPort <int32>

此參數會指定要做為 MDT 監視服務的事件連接埠的 TCP 連接埠。

參數 值
Required? False
位置? 2 和 已命名
預設值 9800
接受管線輸入? False
接受萬用字元嗎? False

-DataPort <int32>

此參數會指定要做為 MDT 監視服務之資料連接埠的 TCP 連接埠。

參數 值
Required? False
位置? 3 和 已命名
預設值 9801
接受管線輸入? False
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

如果包含詳細通用參數,此 Cmdlet 會輸出字串類型物件;否則不會產生任何輸出。

範例 1

Enable-MDTMonitorService

描述

本範例使用事件連接埠的預設值 9800 和 MDT 監視服務上資料連接埠的預設值 9801 啟用本機電腦上的 MDT 監視服務。

範例 2

Enable-MDTMonitorService -EventPort 7000 -DataPort 7001

描述

本範例使用事件連接埠的值 7000 和 MDT 監視服務上資料連接埠的值 7001 ,啟用本機電腦上的 MDT 監視服務。

Get-MDTDeploymentShareStatistics

本節說明 Get-MDTDeploymentShareStatistics Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Get-MDTDeploymentShareStatistics [-Path <String>] [<CommonParameters>]

描述

此 Cmdlet 會根據 Path 參數中指定的 MDTProvder 磁碟機,顯示部署共用的統計資料。 統計資料包括指定部署共用中的項目數:

  • 應用程式

  • 驅動程式

  • 作業系統

  • 套件

  • 工作順序

  • 選取設定檔

  • 連結的部署共用

  • MDT 媒體

  • MDT DB 中的電腦

  • MDT 資料庫中的廠牌和型號

  • MDT 資料庫中的位置

  • MDT DB 中的角色

注意事項

不會填入與 MDT DB 相關的統計資料值,且一律傳回零值。

參數

本小節提供可與 Get-MDTDeploymentShareStatistics Cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

此參數會指定所需部署共用的 MDTProvider Windows PowerShell 磁碟機。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為所需 MDTProvider Windows PowerShell 磁碟機內的位置。

參數 值
Required? False
位置? 2 和 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會輸出包含部署共用統計資料的 PSObject 類型物件。

範例 1

Get-MDTDeploymentShareStatistics -Path DS001:

描述

此範例會傳回在 DS001:MDTProvider Windows PowerShell 磁碟機中指定的部署共用的部署共用統計資料。

範例 2

cd DS001:
Get-MDTDeploymentShareStatistics

描述

此範例會傳回在 DS001:MDTProvider Windows PowerShell 磁碟機中指定的部署共用的部署共用統計資料。 使用 cd 命令將 Windows PowerShell 的工作目錄設定為 DS001:MDTProvider Windows PowerShell 磁碟機。

Get-MDTMonitorData

本節說明 Get-MDTMonitorData Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Get-MDTMonitorData [-Path <String>] [-ID <Nullable>] [<CommonParameters>]

描述

此 Cmdlet 會顯示正在向 Path 參數中指定的部署共用報告的 MDT 監視資料。 以下是此 Cmdlet 的範例輸出:

Name               : WDG-REF-01
PercentComplete    : 100
Settings           :
Warnings           : 0
Errors             : 0
DeploymentStatus   : 3
StartTime          : 5/23/2012 6:45:39 PM
EndTime            : 5/23/2012 8:46:32 PM
ID                 : 1
UniqueID           : 94a0830e-f2bb-421c-b1e0-6f86f9eb9fa1
CurrentStep        : 88
TotalSteps         : 88
StepName           :
LastTime           : 5/23/2012 8:46:32 PM
DartIP             :
DartPort           :
DartTicket         :
VMHost             : WDG-HOST-01
VMName             : WDG-REF-01
ComputerIdentities : {}

注意事項

在執行此 Cmdlet 之前,必須先存在此 Cmdlet 參考的 MDTProvider Windows PowerShell 磁碟機。

參數

本小節提供可與 Get- MDTMonitorData Cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

此參數會指定所需部署共用的 MDTProvider Windows PowerShell 磁碟機。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為所需 MDTProvider Windows PowerShell 磁碟機內的位置。

參數 值
Required? False
位置? 2 和 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-ID <為 Nullable>

這個參數會指定部署特定電腦的特定識別碼。 如果未指定此參數,則會顯示部署共用中部署的所有監視資料。

參數 值
Required? False
位置? 3 和 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

這個 Cmdlet 會針對每部受監視的電腦輸出 PSObject 類型物件,其中包含該電腦的監視資料。

範例 1

Get-MDTMonitorData -Path DS001:

描述

此範例會傳回在 DS001 中指定的部署共用中所有部署的監視資料:MDTProvider Windows PowerShell 磁碟機。

範例 2

cd DS001:
Get-MDTMonitorData

描述

此範例會傳回在 DS001 中指定的部署共用中所有部署的監視資料:MDTProvider Windows PowerShell 磁碟機。 使用 cd 命令將 Windows PowerShell 的工作目錄設定為 DS001:MDTProvider Windows PowerShell 磁碟機。

範例 3

Get-MDTMonitorData -Path DS001: -ID 22

描述

此範例會在 DS001:MDTProvider Windows PowerShell 磁碟機中指定的部署共用中,傳回識別碼為 22 的部署監視資料。

Get-MDTOperatingSystemCatalog

本節說明 Get-MDTOperatingSystemCatalog Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Get-MDTOperatingSystemCatalog [-ImageFile] <String> [-Index] <Int32> [<CommonParameters>]

描述

此 Cmdlet 會擷取或建立自訂作業系統映像的作業系統目錄,以便您使用 Windows 系統映像管理員 (WSIM) 修改對應的 unattend.xml 檔案。 如果沒有作業系統類別目錄可用,或現有的作業系統類別目錄無效或過期,此 Cmdlet 會產生新的作業系統類別目錄。

注意事項

產生新作業系統目錄的程序可能需要很長的時間,因為在作業系統目錄建立完成之前必須裝載、檢查及解除裝載自訂作業系統映像。

參數

本小節提供可與 Get-MDTOperatingSystemCatalog Cmdlet 搭配使用的各種參數的相關資訊。

-ImageFile <字串>

這個參數會指定自訂作業系統映像檔 (.wim 檔案) 的完整路徑,包括自訂作業系統映像檔的名稱。

參數 值
Required? True
位置? 2 和 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-index <int32>

這個參數會指定作業系統映像檔 (.wim 檔案) 內所需作業系統映像的索引。

參數 值
Required? True
位置? 3 和 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

這個 Cmdlet 會輸出包含作業系統目錄路徑的 PSObject 類型物件。

範例 1

Get-MDTOperatingSystemCatalog -ImageFile "DS001:\Operating Systems\Windows 8\sources\install.wim" -Index 2

描述

本範例會以作業系統映像檔 DS001:\Operating Systems\Windows 8\sources\install.wim 中的索引 2 傳回作業系統映像的作業系統目錄。

Get-MDTPersistentDrive

本節說明 Get-MDTPersistentDrive Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Get-MDTPersistentDrive [<CommonParameters>]

描述

這個 Cmdlet 會顯示保存的 MDT Windows PowerShell 磁碟機清單。 保存的 MDT Windows PowerShell 磁碟機清單是使用 Add-MDTPersistentDrive 和 Remove-MDTPersistentDrive Cmdlet 或 Deployment Workbench 進行管理。

此 Cmdlet 的輸出包含下列資訊:

  • Windows PowerShell 磁碟機名稱,例如 DS001

  • 目錄路徑,例如 \\WDG-MDT-01\DeploymentShare$

    保存的 MDT Windows PowerShell 磁碟機類似於保存的網路磁碟機對應。

注意事項

這個保存的 MDT Windows PowerShell 磁碟機清單是根據每位使用者來維護,並儲存在使用者設定檔中。

參數

本小節提供可與 Get- MDTPersistentDrive Cmdlet 搭配使用的各種參數的相關資訊。

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會針對每個 MDT 持續磁碟機輸出 PSObject 類型物件,其與 New-PSDrive Cmdlet 傳回的 PSObject 類型物件相同。

範例 1

Get-MDTPersistentDrive

描述

此範例顯示 MDT 保存磁碟機的清單。

Import-MDTApplication

本節說明 Import-MDTApplication Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Import-MDTApplication [-Path <String>] -Name <String> ApplicationSourcePath <String> -DestinationFolder <String> [-Move] [<CommonParameters>]

-或-

Import-MDTApplication [-Path <String>] -Name <String> NoSource [<CommonParameters>]

-或-

Import-MDTApplication [-Path <String>] -Name <String> Bundle [<CommonParameters>]

描述

此 Cmdlet 會將應用程式匯入部署共用。 您可以使用此 Cmdlet 匯入下列應用程式類型:

  • 具有來源檔案的應用程式,使用 ApplicationSourcePath、 DestinationFolder 和 Move 參數。 第一個語法範例說明如何針對此類型的應用程式使用此 Cmdlet。

  • 沒有來源檔案或來源檔案位於其他網路共用資料夾的應用程式,使用 NoSource 參數。 第二個語法範例說明如何針對這類應用程式使用此 Cmdlet。

  • 應用程式套件組合,用於使用 Bundle 參數來將一組相關應用程式分組。 最後一個語法範例說明如何針對這類應用程式使用此 Cmdlet。

參數

本小節提供可與 Import-MDTApplication Cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

這個參數會指定現有資料夾的完整路徑,將要匯入的應用程式放置在部署共用中。 如果使用 DestinationFolder 參數,則 DestinationFolder 參數中指定的資料夾會在此參數中指定的資料夾下建立。 此參數用於此 Cmdlet 的所有語法用法。

注意事項

如果未提供這個參數,Windows PowerShell 工作目錄必須預設為部署共用內所需的位置。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-Name <字串>

此參數會指定要新增至部署共用的應用程式名稱,且在部署共用中必須是唯一的。 此參數用於此 Cmdlet 的所有語法用法。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-ApplicationSourcePath <字串>

這個參數會指定將匯入至部署共用之應用程式之應用程式來源檔案的完整路徑。 此參數只適用於第一個語法範例。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-DestinationFolder <字串>

此參數會指定部署共用中要匯入應用程式來源檔案的資料夾。 此資料夾會建立在 Path 參數中指定的資料夾底下。 此參數只適用於第一個語法範例。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-移動 [<SwitchParameter>]

這個參數會指定應用程式的來源檔案是否應該移動 (,而不是從應用程式來源檔案所在的資料夾複製) ,這是在 ApplicationSourcePath 參數中指定。

如果此參數為:

  • 指定後,則會移動檔案,並刪除 ApplicationSourcePath 參數中指定資料夾中的檔案

  • 未指定,則會複製檔案並保留 ApplicationSourcePath 參數中指定資料夾中的檔案

    此參數只適用於第一個語法範例。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-NoSource [<切換參數>]

這個參數會指定要匯入的應用程式是沒有要複製的來源檔案的應用程式。 使用此參數時,應用程式來源檔案為:

  • 在應用程式安裝命令列或工作目錄組態設定中指定的網路共用資料夾上

  • 已存在於作業系統映像中

    此參數只適用於第二個語法範例。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

-捆綁 [<SwitchParameter>]

此參數指定要匯入的應用程式是兩個以上應用程式的套件組合的應用程式。 此參數只適用於最後一個語法範例。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會輸出 PSObject 型別物件,該物件會參照剛匯入的應用程式。

範例 1

Import-MDTApplication -Path "DS001:\Applications" -Name "Office 2010 Professional Plus 32-bit" ApplicationSourcePath "\\WDG-MDT-01\Source$\Office2010ProPlus\x86" DestinationFolder "Office2010ProPlusx86"

描述

此範例會從位於 \\WDG-MDT-01\Source$\Office2010ProPlus\x86 的網路共用資料夾匯入具有來源檔案的應用程式,並將來源檔案複製到部署共用內的 DS001:\Applications\Office2010ProPlusx86。 來源檔案會保留。

範例 2

Import-MDTApplication -Path "DS001:\Applications" -Name "Office 2010 Professional Plus 32-bit" ApplicationSourcePath "\\WDG-MDT-01\Source$\Office2010ProPlus\x86" DestinationFolder "Office2010ProPlusx86" -Move

描述

此範例會從位於 \\WDG-MDT-01\Source$\Office2010ProPlus\x86 的網路共用資料夾匯入具有來源檔案的應用程式,並將來源檔案移至部署共用內的 DS001:\Applications\Office2010ProPlusx86。 來源檔案會從位於 \\WDG-MDT-01\Source$\Office2010ProPlus\x86 的網路共用資料夾中移除。 該應用程式名為 Office 2012 專業增強版 32 位元。

範例 3

Import-MDTApplication -Path "DS001:\Applications" -Name "Office 2010 Professional Plus 32-bit" NoSource

描述

此範例會匯入名為 Office 2012 專業增強版 32 位元 的應用程式,但沒有來源檔案。

範例 4

Import-MDTApplication -Path "DS001:\Applications" -Name "Woodgrove Bank Core Applications" Bundle

描述

此範例會匯入名為 Woodgrove Bank Core Applications 的應用程式套件組合。

Import-MDTDriver

本節說明 Import-MDTDriver Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Import-MDTDriver [-Path <String>] -SourcePath <String[]> [ImportDuplicates] [<CommonParameters>]

描述

此 Cmdlet 會將一或多個裝置驅動程式匯入部署共用中。 此 Cmdlet 會從 SourcePath 參數中指定的資料夾開始搜尋裝置驅動程式。 此 Cmdlet 會尋找該資料夾結構中找到的多個裝置驅動程式。

參數

本小節提供可與 Import-MDTDriver cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

這個參數會指定現有資料夾的完整格式路徑,將要匯入的裝置驅動程式放置在部署共用中。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為部署共用中的所需位置。 如果未提供 SourcePath 參數,則必須提供此參數。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-SourcePath <字串[ ]>

這個參數會針對裝置驅動程式檔案所在的來源資料夾,指定字串陣列中的一個或多個完整路徑。 從此參數中指定的資料夾開始的每個資料夾結構都會搜尋裝置驅動程式,包括資料夾結構中的所有子資料夾和 .cab 檔案的內容。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為裝置驅動程式檔案所在的資料夾。 如果未提供 Path 參數,則必須提供此參數。

參數 值
Required? True
位置? 1 和 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-ImportDuplicates [<切換參數>]

此參數會指定此 Cmdlet 是否應匯入重複的裝置驅動程式。 根據預設,不會匯入重複的裝置驅動程式。 透過計算裝置驅動程式資料夾中所有檔案的雜湊值,偵測到重複的裝置驅動程式。 如果計算出的雜湊值與另一個裝置驅動程式相符,則要匯入的裝置驅動程式會被視為重複。

如果偵測到重複的驅動程式,但未提供此參數,則會新增裝置驅動程式並連結到原始的現有裝置驅動程式。

如果此參數為:

  • 指定,則會匯入重複的裝置驅動程式

  • 未指定,則會新增裝置驅動程式並連結到原始的現有裝置驅動程式

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會輸出一或多個 PSObject 類型物件, (每個裝置驅動程式匯入) 一個物件。

範例 1

Import-MDTDriver -Path "DS001:\Out-of-Box Drivers" SourcePath "\\WDG-MDT-01\Source$\Drivers"

描述

此範例會匯入資料夾結構中的所有裝置驅動程式,其資料夾結構的根目錄位於 \\WDG-MDT-01\Source$\Drivers。 裝置驅動程式會儲存在對應至 DS001:MDTProvder Windows PowerShell 磁碟機的部署共用中的 [全新驅動程式] 資料夾中。 如果偵測到任何重複的裝置驅動程式,將會新增裝置驅動程式,並連結到部署共用中的原始現有裝置驅動程式。

範例 2

$DriverSourcePath="\\WDG-MDT-01\Source$\VendorADrivers", "\\WDG-MDT-01\Source$\VendorBDrivers"
Import-MDTDriver -Path "DS001:\Out-of-Box Drivers" SourcePath $DriverSourcePath ImportDuplicates

描述

此範例會匯入字串陣列$DriverSourcePath中指定的資料夾結構中的所有裝置驅動程式。 裝置驅動程式會儲存在對應至 DS001:MDTProvder Windows PowerShell 磁碟機的部署共用中的 [全新驅動程式] 資料夾中。 如果偵測到任何重複的裝置驅動程式,則會匯入重複的裝置驅動程式。

Import-MDTOperatingSystem

本節說明 Import-MDTOperatingSystem Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Import-MDTOperatingSystem [-Path <String>] -SourcePath <String> [-DestinationFolder <String>] [-Move] [<CommonParameters>]

-或-

Import-MDTOperatingSystem [-Path <String>] [DestinationFolder <String>] -SourceFile <String> [SetupPath <String>] [-Move] [<CommonParameters>]

-或-

Import-MDTOperatingSystem [-Path <String>] -WDSServer <String> [<CommonParameters>]

描述

此 Cmdlet 會將作業系統匯入部署共用。 使用此 Cmdlet 可以匯入下列作業系統類型:

  • 原始來源檔案中的作業系統,使用 SourcePath 參數。 第一個語法範例說明如何將此 Cmdlet 用於此類型的作業系統匯入。

  • 自訂作業系統映像檔,例如,使用 SourceFile 參數從參照電腦擷取映像。 第二個語法範例說明如何將此 Cmdlet 用於此類作業系統匯入。

  • 使用 WDSServer 參數在 Windows 部署服務中提供的作業系統映像。 最後一個語法範例說明如何將此 Cmdlet 用於此類型的作業系統匯入。

參數

本小節提供可與 Import-MDTOperatingSystem Cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

這個參數會指定部署共用內現有資料夾的完整路徑,其中將會放置要匯入的作業系統。 如果使用 DestinationFolder 參數,則 DestinationFolder 參數中指定的資料夾會在此參數中指定的資料夾下建立。 此參數用於此 Cmdlet 的所有語法用法。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為部署共用中的所需位置。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-SourcePath <字串>

這個參數會指定將匯入部署共用之作業系統之作業系統來源檔案的完整路徑。 此參數只適用於第一個語法範例。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-DestinationFolder <字串>

這個參數會指定部署共用中要匯入作業系統來源檔案的資料夾。 此資料夾會建立在 Path 參數中指定的資料夾底下。 此參數只適用於第一個和第二個語法範例。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-移動 [<SwitchParameter>]

這個參數會指定是否應將作業系統來源檔案移 (,而不是從作業系統來源檔案所在的資料夾複製) ,這是在 DestinationFolder 參數中指定。

如果此參數為:

  • 指定後,則會移動檔案,並刪除 DestinationFolder 參數中指定資料夾中的檔案

  • 未指定,則會複製檔案並保留 DestinationFolder 參數中指定資料夾中的檔案

    此參數只適用於第一個和第二個語法範例。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-SourceFile <字串>

這個參數會指定將匯入部署共用之作業系統之作業系統來源 .wim 檔案的完整路徑。 此參數只適用於第二個語法範例。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-SetupPath <字串>

這個參數會指定作業系統安裝程式的完整路徑,這些檔案必須與 SourceFile 參數中指定的 .wim 檔一起匯入。 此參數只適用於第二個語法範例。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-WDSServer <字串>

這個參數會指定要匯入的作業系統映像檔所在的 Windows 部署服務伺服器的名稱。 Windows 部署服務伺服器上的所有操作映像檔都將導入到部署共用中。 實際的作業系統映像檔不會複製到部署共用。 相反地,部署共用包含 Windows 部署服務伺服器上每一個作業系統檔案的連結。

此參數只適用於最後一個語法範例。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會輸出一或多個 PSObject 類型物件, (每個匯入) 作業系統各輸出一個物件。

範例 1

Import-MDTOperatingSystem -Path "DS001:\Operating Systems" SourcePath "\\WDGMDT01\Source$\Windows8" DestinationFolder "Windows8x64"

描述

此範例會從位於 \\WDG-MDT-01\Source$\Windows8 的網路共用資料夾匯入作業系統,並將來源檔案複製到部署共用內的 DS001:\Operating Systems\Windows8x64。 來源檔案會保留。

範例 2

Import-MDTOperatingSystem -Path "DS001:\Operating Systems" SourcePath "\\WDGMDT01\Source$\Windows8" DestinationFolder "Windows8x64" -Move

描述

此範例會從位於 \\WDG-MDT-01\Source$\Windows8 的網路共用資料夾匯入作業系統,並將來源檔案複製到部署共用內的 DS001:\Operating Systems\Windows8x64。 來源檔案會從位於 \\WDG-MDT-01\Source$\Windows8 的網路共用資料夾中移除。

範例 3

Import-MDTOperatingSystem -Path "DS001:\Operating Systems" DestinationFolder "Windows8x64-Reference" -SourceFile "\\WDGMDT01\Capture$\WDG-REF-01_Capture.wim"

描述

此範例會從 \\WDG-MDT-01\ Capture$\WDG-REF-01_Capture.wim) 匯入作業系統擷取的自訂映像檔 (.wim 檔案,並將映像檔複製到部署共用內的 DS001:\Operating Systems\Windows8x64-Reference。 來源 .wim 檔案會保留在網路共用資料夾中。

範例 4

Import-MDTOperatingSystem -Path "DS001:\Operating Systems" WDSServer "WDG-WDS-01"

描述

此範例會從名為 WDG-WDS-01 的 Windows 部署服務伺服器匯入所有作業系統映像,並在部署共用內的 DS001:\Operating Systems 中建立每個作業系統映像的連結。 Windows 部署服務伺服器上的來源作業系統映像檔會保留在 Windows 部署服務伺服器上。

Import-MDTPackage

本節說明 Import-MDTPackage Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Import-MDTPackage [-Path <String>] [[-SourcePath] <String[]>] [<CommonParameters>]

描述

此 Cmdlet 會將一或多個作業系統套件匯入部署共用。 可匯入的作業系統套件類型包括安全性更新、語言套件或新元件。 Service Pack 無法離線安裝,因此不應匯入為作業系統套件。

參數

本小節提供可與 Import-MDTPackage Cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

這個參數會指定部署共用內現有資料夾的完整路徑,用於放置要匯入的作業系統套件。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為部署共用中的所需位置。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-SourcePath <字串>

這個參數會指定資料夾結構的完整格式路徑,以掃描以尋找要匯入的作業系統套件。 指定的資料夾結構會掃描 .cab 和 .msu 檔案。 針對 .msu 檔案,系統會自動解壓縮 .msu 檔案內的 .cab 檔案。

參數 值
Required? True
位置? 1 和 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會輸出 PSObject 型別物件,該物件會參照剛匯入的套件。

範例 1

Import-MDTOperatingSystem -Path "DS001:\Packages" SourcePath "\\WDGMDT01\Source$\OSPackages"

描述

此範例會掃描位於 \\WDG-MDT-01\Source$\OSPackages 的網路共用資料夾以尋找作業系統套件,並將來源檔案複製到部署共用內的 DS001:\Packages 資料夾。 來源檔案會從位於 \\WDG-MDT-01\Source$\OSPackages 的網路共用資料夾中移除。

Import-MDTTaskSequence

本節說明 Import-MDTTaskSequence Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Import-MDTTaskSequence [-Path <String>] -Template <String> -Name <String> -ID <String> [[-Comments] <String>] [[-Version] <String>] [-OperatingSystemPath <String>] [-OperatingSystem <PSObject>] [-FullName <String>] [-OrgName <String>] [-HomePage <String>] [-ProductKey <String>] [-OverrideProductKey <String>] [-AdminPassword <String>] [<CommonParameters>]

描述

此 Cmdlet 會將工作順序匯入部署共用。 新匯入的工作順序會以 [範本 ] 屬性中指定的現有工作順序範本為基礎。

參數

本小節提供可與 Import-MDTPackage Cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

此參數會指定部署共用內現有資料夾的完整路徑,其中將會放置要匯入的工作順序。 根據預設,路徑應指向部署共用中的 Control 資料夾和/或 Control 資料夾的子資料夾。 ID 參數的值將用於在此參數中指定的路徑內建立子資料夾。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為部署共用中的所需位置。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-範本 <字串>

此參數會指定要用於匯入新工作順序的工作順序範本。 工作順序範本是 .xml 檔案,其中包含特定類型工作順序的工作順序步驟。 如果工作順序範本位於:

  • installation_folder\Templates 資料夾 (其中installation_folder是安裝 MDT 的資料夾,) 則只需要 .xml 檔案名稱。

  • 則需要另一個資料夾,則需要完整路徑,包括工作順序範本 .xml 的名稱。

    如需適用於 LTI 部署之 MDT 所包含之工作順序範本的詳細資訊,請參閱 MDT 文件中的「 使用 Microsoft 部署工具組,在部署工作台中建立新的工作順序」一節。

參數 值
Required? True
位置? 1 和 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-Name <字串>

此參數會指定要匯入的工作順序名稱。 此參數的值在部署共用中必須是唯一的。

參數 值
Required? True
位置? 2 和 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-ID <字串>

此參數會指定要匯入的工作順序識別碼。 此參數的值在部署共用中必須是唯一的。 指派給此參數的值應為大寫,且不得包含任何空格或特殊字元。 此值可用來在 Path 參數中指定的資料夾中建立子資料夾,該資料夾應該位於部署共用的 Control 資料夾底下。

參數 值
Required? True
位置? 3 和 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-comments <字串>

此參數會指定文字,以提供有關要匯入之工作順序的其他描述性資訊。 此描述性資訊可在 Deployment Workbench 中看見。

參數 值
Required? False
位置? 4 和 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-版本 <字串>

此參數會指定要匯入的工作順序版本號碼。 此參數的值僅供參考,MDT 不會用於版本相關處理。

參數 值
Required? False
位置? 4 和 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-OperatingSystemPath <字串>

這個參數會指定部署共用中資料夾的完整格式 Windows PowerShell 路徑,其中包含要與此工作順序搭配使用的作業系統,例如 DS001:\Operating Systems\Windows 8。 作業系統必須已存在於匯入工作順序的部署共用中。

注意事項

如果您未提供此參數,且工作順序需要參考作業系統,則必須提供 OperatingSystem 參數。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-作業系統 <PSObject>

此參數會指定要與此工作順序搭配使用的作業系統物件。 作業系統必須已存在於匯入工作順序的部署共用中。

您可以使用 Get-Item Cmdlet 擷取作業系統的 Windows PowerShell 物件,如下列範例所示:

$OS=Get-Item "DS001:\Operating Systems\Windows 8"

如需 Get-Item Cmdlet 的詳細資訊,請參閱 使用 Get-Item Cmdlet。

注意事項

如果您未提供此參數,且工作順序需要參考作業系統,則必須提供 OperatingSystemPath 參數。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-FullName <字串>

此參數會指定要與此工作順序搭配使用的作業系統的已登錄擁有者名稱。 此名稱會儲存在 HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion的 RegisteredOwner 登錄機碼中。 此參數的值會插入 Unattend.xml 檔案以與此工作順序相關聯。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-OrgName <字串>

此參數會指定要與此工作順序搭配使用的作業系統的已登錄擁有者的組織名稱。 此名稱會儲存在 HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion的 RegisteredOrganization 登錄機碼中。 此參數的值會插入 Unattend.xml 檔案以與此工作順序相關聯。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-HomePage <字串>

這個參數會指定要在 Internet Explorer 中做為首頁的 URL。 此參數的值會插入 Unattend.xml 檔案以與此工作順序相關聯。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-ProductKey <字串>

此參數會指定要用於此工作順序之作業系統的產品金鑰。 此產品金鑰只適用於零售版本的 Windows 作業系統。 此參數的值會插入 Unattend.xml 檔案以與此工作順序相關聯。

注意事項

如果未提供此參數,則在部署精靈、CustomSettings.ini 檔案或 MDT DB 中部署此工作順序時必須提供產品金鑰。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-OverrideProductKey <字串>

此參數會指定要用於作業系統與此工作順序搭配使用的 MAK 金鑰。 此產品金鑰只適用於 Windows 大量授權版本。 此參數的值會插入 Unattend.xml 檔案以與此工作順序相關聯。

注意事項

如果未提供此參數,則在部署精靈、CustomSettings.ini 檔案或 MDT DB 中部署此工作順序時必須提供 MAK 金鑰。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-AdminPassword <字串>

這個參數會指定要指派給目標電腦上內建的本機 Administrator 帳戶的密碼。 此參數的值會插入 Unattend.xml 檔案以與此工作順序相關聯。

注意事項

如果未提供此參數,則在部署精靈、CustomSettings.ini 檔案或 MDT 資料庫中部署此工作順序時,必須提供要指派給目標電腦上內建本機系統管理員帳戶的密碼。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會輸出 PSObject 類型物件,其會參照剛匯入的工作順序。

範例 1

Import-MDTTaskSequence -Path "DS001:\Control" -Template "Client.xml" -Name "Deploy Windows 8 to Reference Computer" -ID "WIN8REFERENCE" -Comments "Task sequence for deploying Windows 8 to the reference computer (WDG-REF-01)" -Version "1.00" -OperatingSystemPath "DS001:\Operating Systems\Windows 8_x64" -FullName "Woodgrove Bank Employee" -OrgName "Woodgrove Bank" HomePage "https://www.woodgrovebank.com"  OverrideProductKey "1234512345123451234512345" AdministratorPassword "P@ssw0rd"

描述

此範例會匯入名為 [部署Windows 8至參考電腦] 的任務順序,並在部署共用的 DS001:\Control\WIN8REFERENCE 資料夾中建立工作順序。 註解「用於將 Windows 8 部署到參照電腦 (WDG-REF-01) 」會指派給工作順序。 工作順序的版本號碼設定為 1.00。

與工作順序相關聯的作業系統位於部署共用中的 DS001:\Operating Systems\Windows 8_x64。 作業系統的登錄擁有者將會設定為 Woodgrove Bank 員工。 作業系統的註冊組織將設定為 Woodgrove Bank。 Internet Explorer 首頁將預設為 https://www.woodgrovebank.com。 本機內建 Administrator 帳戶的密碼會設定為 的值 P@ssw0rd。 作業系統的產品金鑰會設定為 1234512345123451234512345。

範例 2

$OSObject=Get-Item "DS001:\Operating Systems\Windows 8_x64"
Import-MDTTaskSequence -Path "DS001:\Control" -Template "Client.xml" -Name "Deploy Windows 8 to Reference Computer" -ID "WIN8REFERENCE" -Comments "Task sequence for deploying Windows 8 to the reference computer (WDG-REF-01)" -Version "1.00"-OperatingSystem $OSObject -FullName "Woodgrove Bank Employee" -OrgName "Woodgrove Bank" HomePage "https://www.woodgrovebank.com"  AdministratorPassword "P@ssw0rd"

描述

此範例會匯入名為 [部署Windows 8至參考電腦] 的任務順序,並在部署共用的 DS001:\Control\WIN8REFERENCE 資料夾中建立工作順序。 註解「用於將 Windows 8 部署到參照電腦 (WDG-REF-01) 」會指派給工作順序。 工作順序的版本號碼設定為 1.00。

與工作順序相關聯的作業系統位於部署共用中的 DS001:\Operating Systems\Windows 8_x64,會使用 $OSObject 變數傳遞給 Cmdlet。 $OSObject變數是使用 Get-Item Cmdlet 設定為現有的作業系統物件。

作業系統的登錄擁有者將會設定為 Woodgrove Bank 員工。 作業系統的註冊組織將設定為 Woodgrove Bank。 Internet Explorer 首頁將預設為 https://www.woodgrovebank.com。 本機內建 Administrator 帳戶的密碼會設定為 的值 P@ssw0rd。 在部署精靈、CustomSettings.ini 檔案或 MDT DB 中部署此工作順序時,必須提供作業系統的產品金鑰。

New-MDTDatabase

本節說明 New-MDTDatabase Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

New-MDTDatabase [-Path <String>] [-Force] -SQLServer <String> [-Instance <String>] [-Port <String>] [-Netlib <String>] -Database <String> [-SQLShare <String>] [<CommonParameters>]

描述

此 Cmdlet 會建立與部署共用相關聯的新 MDT DB 資料庫。 每個部署共用只能與一個 MDT DB 資料庫相關聯。

參數

本小節提供可與 New-MDTDatabase Cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

這個參數會指定部署共用的完整格式 Windows PowerShell 路徑,新 MDT 資料庫將與之相關聯。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為部署共用中的所需位置。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-Force [<SwitchParameter>]

此參數指定如果 Database 參數中指定的資料庫已存在,則應重新建立 MDT DB 內的資料表。 如果此參數為:

  • ,則會重新建立現有 MDT 資料庫內的資料表

  • 省略,則不會重新建立現有 MDT DB 內的資料表

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

-SQLServer <字串>

這個參數會指定執行 SQL Server 的電腦名稱,用於建立新的 MDT DB 資料庫。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-實例 <字串>

此參數會指定將在其中建立新 MDT 資料庫的 SQL Server 執行個體。 如果省略此參數,則會在預設 SQL Server 執行個體中建立 MDT 資料庫資料庫。

注意事項

SQL Server 瀏覽器服務必須在執行 SQL Server 的電腦上執行,Cmdlet 才能找到此參數中指定的實例。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-連接埠 <字串>

此參數會指定與 SQLServer 參數中指定的 SQL Server 執行個體通訊時所使用的 TCP 連接埠。 SQL Server 使用的預設連接埠是 1433。 當 SQL Server 設定為使用預設值以外的連接埠時,請指定此參數。 此參數的值必須與為 SQL Server 設定的連接埠相符。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-netlib <字串>

此參數會指定與 SQLServer 參數中指定的 SQL Server 執行個體通訊時所使用的 SQL Server 網路程式庫。 參數可以設定為下列其中一個值:

  • DBNMPNTW,用來指定具名管道通訊

  • DBSMSOCN,用來指定 TCP/IP 通訊端通訊

    如果未提供此參數,則會使用網路程式庫 (DBNMPNTW) SQL Server具名管道。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-資料庫 <字串>

這個參數會指定要在 SQLServer 參數中指定的 SQL Server 上的 Instance 參數中所指定之 SQL Server 執行個體中建立的資料庫名稱。 建立資料庫時,資料庫和記錄檔會使用預設位置和命名慣例。

如果此參數中指定的資料庫已存在,將不會重新建立資料庫。 您可以根據 Force 參數重新建立資料庫內的資料表。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-SQLShare <字串>

這個參數會指定執行 SQL Server 之電腦上的網路共用資料夾名稱。 此連線可用來使用具名管道通訊協定建立 Windows 整合式安全性連線。

注意事項

如果未包含此參數,則不會建立安全的 IPC$ 連線。 因此,與 SQL Server 的具名管道通訊可能會失敗。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會針對已建立的新 MDT DB 輸出 PSObject 類型物件。

範例 1

New-MDTDatabase -Path "DS001:" -SQLServer "WDGSQL01" Database "MDTDB" -SQLShare "\\WDGSQL01\MDTShare$"

描述

本範例會在名為 WDG-SQL-01 的電腦上的預設 SQL Server 執行個體中建立名為 MDTDB 的 MDT DB。如果資料庫已存在,將不會重新建立現有資料庫中的資料表。 將會使用預設的 SQL Server TCP 連接埠和具名管道通訊協定建立連線。

範例 2

New-MDTDatabase -Path "DS001:" -Force -SQLServer "WDGSQL01" -Instance "MDTInstance" Database "MDTDB" -SQLShare "\\WDGSQL01\MDTShare$"

描述

本範例會在名為 WDG-SQL-01 的電腦上,在名為 MDTInstance 的 SQL Server 執行個體中建立名為 MDTDB 的 MDT 資料庫。如果資料庫已存在,則會重新建立現有資料庫中的資料表。 將會使用預設的 SQL Server TCP 連接埠和具名管道通訊協定建立連線。

Remove-MDTMonitorData

本節說明 Get-MDTPersistentDrive Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Remove-MDTMonitorData [-Path <String>] [-ID <Int32>] [<CommonParameters>]

-或-

Remove-MDTMonitorData [-Path <String>] [-ComputerObject <PSObject>] [<CommonParameters>]

描述

此 Cmdlet 會從部署共用中現有收集的監視資料移除已收集的監視資料。 您可以指定以下項目來識別要移除的監視資料:

  • 識別碼 (識別碼 識別碼 特定部署共用的監視項目) 。 監視項目識別碼會在為部署共用建立項目時自動產生並指派給項目。 第一個語法範例說明此用法。

  • 部署共用中監視項目的電腦物件。 您可以使用 Get-MDTMonitorData Cmdlet 取得電腦物件。 最後一個語法範例說明此用法。

注意事項

一旦刪除了監控資料,就沒有恢復資訊的方法。

參數

本小節提供可與 Get- MDTMonitorData Cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

此參數會指定所需部署共用的 MDTProvider Windows PowerShell 磁碟機。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為所需 MDTProvider Windows PowerShell 磁碟機內的位置。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-ID <為 Nullable>

此參數使用監控資料項目的識別碼指定要移除的監控資料項目。 如果未指定此參數,則必須指定 ComputerObject 參數來識別特定的監視資料項目。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

-ComputerObject <PSObject>

此參數指定要使用電腦物件移除的監視資料項目。 如果未指定此參數,則必須指定 ID 參數來識別特定的監視資料項目。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

如果包含詳細通用參數,此 Cmdlet 可能會輸出字串類型物件;否則不會產生任何輸出。

範例 1

Remove-MDTMonitorData -Path "DS001:" -ID 3

描述

此範例會從 Windows PowerShell 路徑 DS001: 的部署共用中移除識別碼值為 3 的監視資料項目。

範例 2

Remove-MDTMonitorData -ID 3

描述

此範例會從預設 Windows PowerShell 路徑的部署共用中移除識別碼值為 3 的監視資料項目。

範例 3

$MonitorObject=Get-MDTMonitorData | Where-Object {$_.Name eq 'WDG-REF-01'}
Remove-MDTMonitorData -ComputerObject $MonitorObject

描述

本範例會移除電腦名稱為 WDG-REF-01 的任何監視資料項目。 您可以使用 Get-MDTMonitorData Cmdlet 和 Where-Object Cmdlet 找到物件。 如需有關 Where-Object Cmdlet 的詳細資訊,請參閱 使用 Where-Object Cmdlet。

Remove-MDTPersistentDrive

本節說明 Remove-MDTPersistentDriveWindows Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Remove-MDTPersistentDrive [-Name] <String> [[-InputObject] <PSObject>] [<CommonParameters>]

描述

這個 Cmdlet 會從使用 Restore-MDTPersistentDrive Cmdlet 保存在 Deployment Workbench 或 Windows PowerShell 工作階段中的磁碟機清單中移除使用 MDTProvider 建立的現有 Windows PowerShell 磁碟機。 當部署共用在 Deployment Workbench 中關閉 (從) 中移除時,會呼叫此 Cmdlet。

注意事項

保存的 MDTProvider 磁碟機清單會根據使用者設定檔中的每個使用者進行維護。

您可以使用 Get-MDTPersistentDrive Cmdlet 來顯示保存的 MDTProvider 磁碟機清單。 您可以使用 Add-MDTPersistentDrive Cmdlet 將 MDTProvider 磁碟機新增至保存磁碟機清單。

參數

本小節提供可與 Add-MDTPersistentDriveWindows Cmdlet 搭配使用的各種參數的相關資訊。

-Name <字串>

指定使用 MDT 提供者建立的 Windows PowerShell 磁碟機名稱,並對應至現有的部署共用。 名稱是使用 New-PSDrive Cmdlet 並在 PSProvider 參數中指定 MDTProvider 所建立的。

如需如何使用 MDTProvider 建立新的 Windows PowerShell 磁碟機,以及如何使用 Windows PowerShell 建立部署共用的詳細資訊,請參閱 MDT 文件《Microsoft 部署工具組範例指南》中的「使用 Windows PowerShell 建立部署共用」一節。

參數 值
Required? True
位置? 1 和 已命名
預設值 無
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

-InputObject <PSObject>

這個參數會指定在此程序中稍早建立的 Windows PowerShell 磁碟機物件。 輸入 PSObject 物件,例如由 New-PSDrive Cmdlet 產生的物件。

參數 值
Required? False
位置? 2 和 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 不提供任何輸出。

範例 1

Remove-MDTPersistentDrive -Name "DS001:"

描述

本範例會從保存磁碟機清單中移除具有 DS001 Windows PowerShell 磁碟機名稱的部署共用。

範例 2

$MDTPSDrive = Get-PSDrive | Where-Object {$_.Root -eq "C:\DeploymentShare" -and $_.Provider -like "*MDTProvider"}
Remove-MDTPersistentDrive -InputObject $MDTPSDrive

描述

本範例會從保存磁碟機清單中移除位於 C:\DeploymentShare$ 的部署共用。 GetPSDrive 和 Where-Object Cmdlet 可用來使用 $MDTPSDrive 變數將 MDT 保存的Windows PowerShell磁碟機傳回 Remove-MDTPersistentDrive Cmdlet。 如需有關 Where-Object Cmdlet 的詳細資訊,請參閱 使用 Where-Object Cmdlet。 如需有關 Get-PSDrive Cmdlet 的詳細資訊,請參閱 使用 Get-PSDrive Cmdlet。

Restore-MDTPersistentDrive

本節說明 Restore-MDTPersistentDrive Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Restore-MDTPersistentDrive [-Force] [<CommonParameters>]

描述

這個 Cmdlet 會針對新增至保存的 Windows PowerShell 磁碟機清單中的每個部署共用,將保存的 MDT Windows PowerShell 磁碟機還原到作用中的 Windows PowerShell 磁碟機清單。 保存的 MDT Windows PowerShell 磁碟機清單是使用 Add-MDTPersistentDrive 和 Remove-MDTPersistentDrive Cmdlet 或 Deployment Workbench 進行管理。

此 Cmdlet 會呼叫 New-PSDrive Cmdlet,為 MDT 保存清單中的每個磁碟機建立 Windows PowerShell 磁碟機。 保存的 MDT Windows PowerShell 磁碟機類似於保存的網路磁碟機對應。

注意事項

這個保存的 MDT Windows PowerShell 磁碟機清單是根據每位使用者來維護,並儲存在使用者設定檔中。

參數

本小節提供可與 Restore-MDTPersistentDrive Cmdlet 搭配使用的各種參數的相關資訊。

-Force [<SwitchParameter>]

這個參數會指定還原時,部署共用應升級 (必要時) 。 如果此參數為:

  • 提供,則部署共用將在還原時升級 (視需要)

  • 省略,則還原時不會升級部署共用

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會針對每個還原的 MDT 提供者 Windows PowerShell 磁碟機輸出 PSObject 類型物件。

範例 1

Get-MDTPersistentDrive

描述

本範例使用 MDTProvider 類型建立 Windows PowerShell 磁碟機,以還原 MDT 保存磁碟機的清單。 還原時將不會升級部署共用。

範例 2

Get-MDTPersistentDrive -Force

描述

本範例使用 MDTProvider 類型建立 Windows PowerShell 磁碟機,以還原 MDT 保存磁碟機的清單。 如果需要) ,還原 (將會升級部署共用。

Set-MDTMonitorData

本節說明 Get-MDTPersistentDrive Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Set-MDTMonitorData [-Path <String>] [-ComputerObject <PSObject>] [-Settings <Hashtable>] [<CommonParameters>]

-或-

Set-MDTMonitorData [-Path <String>] [-MacAddress <String>] [Settings <Hashtable>] [<CommonParameters>]

描述

此 Cmdlet 會在部署共用中建立新的監視資料項目,或更新現有的監視資料項目。 您可以指定以下項目來識別要移除的監視資料:

  • 部署共用中監視項目的電腦物件。 您可以使用 Get-MDTMonitorData Cmdlet 取得電腦物件。 第一個語法範例說明此用法。

  • 用於特定部署共用的監視項目的主要網路介面卡的 MAC 位址。 為部署共用建立項目時,MAC 位址會自動指派給監控資料項目。 最後一個語法範例說明此用法。

注意事項

一旦刪除了監控資料,就沒有恢復資訊的方法。

參數

本小節提供可與 Get- MDTMonitorData Cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

此參數會指定所需部署共用的 MDTProvider Windows PowerShell 磁碟機。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為所需 MDTProvider Windows PowerShell 磁碟機內的位置。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-ComputerObject <PSObject>

此參數會指定要使用電腦物件建立或更新的監視資料項目。 如果未指定此參數,則必須指定 MACAddress 參數來識別特定的監視資料專案。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

-MACAddress <字串>

這個參數會指定要使用所監視電腦的主要網路介面卡的 MAC 位址建立或更新的監視資料項目。 MACAddress 的格式為 xx:xx:xx:xx:xx:xx, 其中 x 是十六進位字元,視需要) 以大寫 (指定。 如果未指定此參數,則必須指定 ComputerObject 參數來識別特定的監視資料項目。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

-設定 <雜湊表>

此參數會指定要建立或更新之監視資料項目的監視資料設定。 此參數提供的雜湊表格式為 @{"Setting"="Value"; "Setting1"="Value1"; "Setting2"="Value2}。 如果未指定此參數,則會建立監視資料項目,但不會儲存任何監視資訊。

"Setting" 可以是 ZTIGather.xml 檔中列出的任何屬性。 Value 可以是在 中 "Setting"所指定屬性的任何有效值。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 不會產生任何輸出。

範例 1

$MonitorObject=Get-MDTMonitorData | Where-Object {$_.Name eq 'WDG-REF-01'}
Set-MDTMonitorData -ComputerObject $MonitorObject Setting @{"OSDComputerName"="WDG-MDT-01";"SkipWizard"="YES"}

描述

本範例會移除電腦名稱為 WDG-REF-01 的任何監視資料項目。您可以使用 Get-MDTMonitorData Cmdlet 和 Where-Object Cmdlet 找到物件。 如需有關 Where-Object Cmdlet 的詳細資訊,請參閱 使用 Where-Object Cmdlet。 OSDComputerName 屬性會記錄為具有 WDG-MDT-01 的值,而 SkipWizard 屬性會記錄為具有 YES 的值。

範例 2

Set-MDTMonitorData -MACAddress "00:11:22:33:44:55" MonitorObject Setting @{"OSDComputerName"="WDG-MDT-01";"SkipWizard"="YES"}

描述

此範例使用值為 00:11:22:33:44:55 的 MACAddress 建立或更新監視資料項目。 OSDComputerName 屬性會記錄為具有 WDG-MDT-01 的值,而 SkipWizard 屬性會記錄為具有 YES 的值。

Test-MDTDeploymentShare

雖然此 Cmdlet 會使用 Get-Command Cmdlet 傳回,因為位於 Microsoft.BDD.PSSnapIn 嵌入式管理單元中,但並未實作。

Test-MDTMonitorData

本節說明 Test-MDTMonitorData Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Test-MDTMonitorData -ServerName <String> -EventPort <Int32> -DataPort <Int32> [<CommonParameters>]

描述

此 Cmdlet 會驗證在安裝 MDT 的電腦上執行的 MDT 監視服務是否已啟用並正常執行。 MDT 監視服務會收集可顯示的監視資訊:

注意事項

若要讓此 Cmdlet 正常運作,部署共用中必須至少有一個 MDT 監視資料項目。 如果尚未記錄任何 MDT 監視資訊,則部署共用將無法通過測試。

如需 MDT 監視服務的詳細資訊,請參閱 MDT 文件中的「監視 MDT 部署」一節, 使用 Microsoft 部署工具組。

參數

本小節提供可與 Test-MDTMonitorData Cmdlet 搭配使用的各種參數的相關資訊。

-伺服器 <字串>

指定安裝 MDT 且正在執行 MDT 監視服務的電腦名稱。

參數 值
Required? True
位置? 已命名
預設值 無
接受管線輸入? False
接受萬用字元嗎? False

-DataPort <int32>

此參數會指定要做為 MDT 監視服務之資料連接埠的 TCP 連接埠。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-EventPort <int32>

此參數會指定要做為 MDT 監視服務的事件連接埠的 TCP 連接埠。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

這個 Cmdlet 會輸出布林值,代表文字的 True) (成功或失敗 (False) 。

範例 1

Test-MDTMonitorData -Server "WDG-MDT-01" -DataPort "9801" EventPort "9800"

描述

此範例會驗證 WDG-MDT-01 上的 MDT 監視服務是否已安裝並執行中。 Cmdlet 會使用資料連接埠 9801 和事件連接埠 9800 進行驗證。

Update-MDTDatabaseSchema

本節說明 Update-MDTDatabaseSchema Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Update-MDTDatabaseSchema -SQLServer <String> [-Instance <String>] [-Port <String>] [-Netlib <String>] -Database <String> [-SQLShare <String>] [<CommonParameters>]

描述

此 Cmdlet 會將現有的 MDT DB 資料庫更新為最新版本的 MDT DB 資料庫架構。 每個部署共用只能與一個 MDT DB 資料庫相關聯。

升級部署共用時,系統會自動呼叫此 Cmdlet,例如執行具有強制參數和 Update-MDTDeploymentShare Cmdlet 的 Restore-MDTPersistentDrive Cmdlet 時。

參數

本小節提供可與 Upgrade-MDTDatabaseSchema Cmdlet 搭配使用的各種參數的相關資訊。

-SQLServer <字串>

這個參數會指定執行 SQL Server 的電腦名稱,其中要升級 MDT 資料庫資料庫。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-實例 <字串>

此參數會指定要升級的 MDT DB 資料庫所在的 SQL Server 執行個體。 如果省略此參數,則會假設 MDT DB 資料庫位於預設的 SQL Server 執行個體中。

注意事項

SQL Server 瀏覽器服務必須在執行 SQL Server 的電腦上執行,Cmdlet 才能找到此參數中指定的實例。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-連接埠 <字串>

此參數會指定與 SQLServer 參數中指定的 SQL Server 執行個體通訊時所使用的 TCP 連接埠。 SQL Server 使用的預設連接埠是 1433。 當 SQL Server 設定為使用預設值以外的連接埠時,請指定此參數。 此參數的值必須與為 SQL Server 設定的連接埠相符。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-netlib <字串>

這個參數會指定用於與 SQLServer 參數中指定的 SQL Server 執行個體通訊的 SQL Server 網路程式庫。 參數可以設定為下列其中一個值:

  • DBNMPNTW,用來指定具名管道通訊

  • DBSMSOCN,用來指定 TCP/IP 通訊端通訊

    如果未提供此參數,則會使用網路程式庫 (DBNMPNTW) SQL Server具名管道。

注意事項

Deployment Workbench 不提供設定 SQL Server 網路程式庫的選項。 Deployment Workbench 一律會使用具名管道通訊。 不過,您可以在 CustomSettings.ini 檔案中設定 SQL Server 網路程式庫。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-資料庫 <字串>

此參數會指定在 SQLServer 參數中指定的 SQL Server 執行個體上的 Instance 參數中指定的 SQL Server 執行個體中要升級的資料庫名稱。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會輸出已升級 MDT 資料庫的 PSObject 類型物件。 如果包含詳細通用參數,此 Cmdlet 也會輸出字串類型資料。

範例 1

Update-MDTDatabaseSchema -SQLServer "WDGSQL01" Database "MDTDB"

描述

本範例會在名為 WDG-SQL-01 的電腦上的預設 SQL Server 執行個體中,更新名為 MDTDB 的 MDT 資料庫結構描述。將會使用預設的 TCP 連接埠和具名管道通訊協定與 SQL Server 執行個體建立連線。

範例 2

Update-MDTDatabaseSchema -SQLServer "WDGSQL01" -Instance "MDTInstance" -Port "6333" Database "MDTDB"

描述

本範例會在名為 WDG-SQL-01 的電腦上,更新名為 MDTInstance 的 SQL Server 執行個體中名為 MDTDB 的 MDT 資料庫結構描述。將會使用 TCP 埠 6333 和具名管道通訊協定與 SQL Server 建立連線。

Update-MDTDeploymentShare

本節說明 Update-MDTDeploymentShare Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Update-MDTDeploymentShare [-Path <String>] [-Force] [Compress] [<CommonParameters>]

描述

此 Cmdlet 會使用 Windows ADK 中的最新檔案更新現有的部署共用。 此 Cmdlet 也會以 WIM 和 ISO 檔案格式更新或重新產生所需的 Windows PE 開機映像。

參數

本小節提供可與 Update-MDTDeploymentShare Cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

這個參數會指定要更新之部署共用中現有資料夾的完整路徑。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為部署共用中的所需位置。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

-Force [<SwitchParameter>]

這個參數會指定是否應該完全重新產生部署共用所) Windows PE 開機映像 (.iso 和 .wim 檔案。 如果此參數為:

  • 提供,則 Cmdlet 會建立新版本的 Windows PE 開機映像。 此程序比最佳化現有的 Windows PE 開機映像還要花費更多時間。

  • 省略,則 Cmdlet 會最佳化現有的 Windows PE 開機映像。 此程序比產生新版本的 Windows PE 開機映像所花費的時間更少。 如果省略此參數,則可以在 Windows PE 開機映像最佳化程序中,使用 Compress 參數來縮減開機映像的大小。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

-壓縮 [<SwitchParameter>]

這個參數會指定當部署共用所) 的 Windows PE 開機映像 (.iso 和 .wim 檔案進行最佳化 (時,是否應該壓縮這些檔案而不使用 Force 參數) 。 如果此參數為:

  • 提供,則 Cmdlet 會在 Windows PE 開機映像優化時對其進行壓縮

  • 省略,則 Cmdlet 不會在優化 Windows PE 開機映像時對其進行壓縮

注意事項

只有在未提供 [強制] 參數時,才應提供此參數。 如果包含 Force 參數,則會產生新的 Windows PE 開機映像,並壓縮為最小大小。

參數 值
Required? False
位置? 已命名
預設值 -
接受管線輸入? True (ByValue)
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會輸出字串類型資料,如果包含詳細資訊常見參數,則會產生額外的字串類型資料。

範例 1

Update-MDTDepoymentShare

描述

本範例會更新 Windows PowerShell 工作目錄中的部署共用。 Windows PE 開機映像將會最佳化。 不會壓縮 Windows PE 開機映像。

範例 2

Update-MDTDepoymentShare -Path "DS001:"

描述

此範例會更新名為 DS001: 的 MDT Windows PowerShell 磁碟機上的部署共用。Windows PE 開機映像將會最佳化。 不會壓縮 Windows PE 開機映像。

範例 3

Update-MDTDepoymentShare -Path "DS001:" -Compress

描述

此範例會更新名為 DS001: 的 MDT Windows PowerShell 磁碟機上的部署共用。Windows PE 開機映像將會最佳化。 Windows PE 開機映像將會壓縮。

範例 4

Update-MDTDepoymentShare -Path "DS001:" -Force

描述

此範例會更新名為 DS001: 的 MDT Windows PowerShell 磁碟機上的部署共用。將會產生新版本的 Windows PE 開機映像。

Update-MDTLinkedDS

本節說明 Update-MDTLinkedDS Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Update-MDTLinkedDS -Path <String> [<CommonParameters>]

描述

這個 Cmdlet 會使用用來定義連結的部署共用的選取設定檔,將部署共用中的內容複寫到連結的部署共用。 複寫行為是根據連結部署共用的組態設定所決定。

參數

本小節提供可與 Update-MDTLinkedDS Cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

這個參數會指定要更新之連結部署共用的完整路徑。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為部署共用中的所需位置。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會輸出字串類型資料,如果包含詳細資訊常見參數,則會產生額外的字串類型資料。

範例 1

Update-MDTLinkedDS -Path "DS001:\Linked Deployment Shares\LINKED001"

描述

此範例會將內容從部署共用複寫到位於Windows PowerShell路徑 DS001:\Linked Deployment Shares\LINKED001 資料夾的連結部署共用。

Update-MDTMedia

本節說明 Update-MDTMedia Windows PowerShell Cmdlet。 從載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台執行此 Cmdlet。 如需有關如何啟動已載入 MDT PowerShell 嵌入式管理單元的 Windows PowerShell 主控台的詳細資訊,請參閱〈載入 MDT Windows PowerShell 嵌入式管理單元〉。

語法

Update-MDTMedia -Path <String> [<CommonParameters>]

描述

這個 Cmdlet 會使用用來定義部署媒體的選取設定檔,將內容從部署共用複寫到包含部署媒體的資料夾。 複寫行為是根據部署媒體的組態設定所決定。

LTI 中的媒體可讓您只從本機媒體執行 LTI 部署,而不需連線到部署共用。 您可以將媒體儲存在 DVD、USB 硬碟或其他可攜式裝置上。 建立媒體之後,產生可開機的 WIM 映像,以便從目標電腦上本機可用的可攜式媒體裝置執行部署。

參數

本小節提供可與 Update-MDTMedia Cmdlet 搭配使用的各種參數的相關資訊。

-路徑 <字串>

這個參數會指定包含要更新之部署媒體的資料夾的完整路徑。

注意事項

如果未提供這個參數,則 Windows PowerShell 工作目錄必須預設為部署共用中的所需位置。

參數 值
Required? True
位置? 已命名
預設值 -
接受管線輸入? False
接受萬用字元嗎? False

<CommonParameters>

此 Cmdlet 支援下列常見參數: Verbose、Debug、ErrorAction、ErrorVariable、OutBuffer、OutVariable、WarningAction 和 WarningVariable。 如需詳細資訊,請參閱「about_CommonParameters」主題,您可以輸入下列命令,然後按 ENTER 來存取該命令:

Get-Help about_CommonParameters

輸出

此 Cmdlet 會輸出字串類型資料,如果包含詳細資訊常見參數,則會產生額外的字串類型資料。

範例 1

Update-MDTMedia -Path "DS001:\Media\MEDIA001"

描述

此範例會將內容從部署共用複寫到包含部署媒體的資料夾,位於Windows PowerShell路徑 DS001:\Media \MEDIA001 資料夾。