Get-DscConfiguration

  • 参考
模块:
PSDesiredStateConfiguration

获取节点的当前配置。

语法

Get-DscConfiguration
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

说明

cmdlet Get-DscConfiguration 获取节点的当前配置（如果存在）。 通过使用通用信息模型 (CIM) 会话指定计算机。 如果不指定目标计算机，则该 cmdlet 将获取本地计算机的配置。

示例

示例 1：获取本地计算机的配置

Get-DscConfiguration

此命令获取本地计算机的当前状态。

示例 2：获取指定计算机的配置

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Get-DscConfiguration -CimSession $Session

此示例从 CIM 会话指定的计算机获取当前状态。 该示例为名为 Server01 的计算机创建 CIM 会话，以供与 cmdlet 一起使用。 或者，创建一个 CIM 会话数组以将 cmdlet 应用到多个指定的计算机。

第一个命令使用 New-CimSession cmdlet 创建 CIM 会话，然后将 CimSession 对象存储在 $Session 变量中。 该命令会提示你输入密码。 要了解详情，请键入 Get-Help New-CimSession。

第二个命令将获取由存储在 $Session 变量中的 CimSession 对象标识的计算机（在此示例中，为名为 Server01 的计算机）的当前配置。

参数

-AsJob

指示此 cmdlet 将命令作为后台作业运行。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

在远程会话中或在远程计算机上运行 cmdlet。 输入计算机名称或会话对象，例如 New-CimSession 或 Get-CimSession cmdlet 的输出。 默认为本地计算机上的当前会话。

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

指定可为运行 cmdlet 而确立的操作的最大数量。 如果省略此参数或输入值 0 ，则Windows PowerShell根据计算机上运行的 CIM cmdlet 数计算 cmdlet 的最佳限制。 该限制仅适用于当前 cmdlet，不适用于会话或计算机。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False