Test-DscConfiguration

Модуль:

PSDesiredStateConfiguration Module v1.1

Проверяет, соответствует ли фактическая конфигурация на узлах требуемой конфигурации.

Синтаксис

ComputerNameSet (по умолчанию)

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

ComputerNameAndPathSet

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Path] <String>
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

ComputerNameAndReferenceConfigurationSet

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    -ReferenceConfiguration <String>
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

CimSessionAndPathSet

Test-DscConfiguration
    [-Path] <String>
    -CimSession <CimSession[]>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

CimSessionAndReferenceConfigurationSet

Test-DscConfiguration
    -CimSession <CimSession[]>
    -ReferenceConfiguration <String>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

CimSessionSet

Test-DscConfiguration
    -CimSession <CimSession[]>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

Описание

Командлет Test-DscConfiguration проверяет, соответствует ли фактическая конфигурация на узлах желаемой конфигурации. Укажите, для каких компьютеров требуется протестировать конфигурации, используя имена компьютеров или сеансы Common Information Model (CIM). Если целевой компьютер не указан, конфигурация командлета проверяет конфигурацию локального компьютера.

Если нужные и фактические конфигурации соответствуют, командлет возвращает строковое значение true. В противном случае возвращает строковое значение false.

Примеры

Пример 1. Проверка конфигурации локального компьютера

Test-DscConfiguration

Эта команда проверяет конфигурацию локального компьютера.

Пример 2. Проверка конфигурации для указанного компьютера

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

В этом примере тестовая конфигурация с компьютера, указанного сеансом CIM. В примере создается сеанс CIM для компьютера с именем Server01 для использования с командлетом. Кроме того, создайте массив сеансов CIM для применения командлета к нескольким указанным компьютерам.

Первая команда создает сеанс CIM с помощью командлета New-CimSession, а затем сохраняет объект CimSession в переменной $Session. Командная строка задает пароль. Для получения дополнительной информации введите Get-Help New-CimSession.

Вторая команда проверяет конфигурацию компьютеров, определенных объектами CimSession , хранящимися $Session в переменной, в данном случае компьютером с именем Server01.

Пример 3: Тестовые конфигурации с подробными результатами

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

Эта команда проверяет конфигурации для набора компьютеров, указанного параметром ComputerName , и возвращает подробные сведения, включая общее состояние, ресурсы, которые находятся в требуемом состоянии, ресурсы, которые не находятся в нужном состоянии, и имя компьютера.

Пример 4: Тестовые конфигурации, указанные в папке

Test-DscConfiguration -Path "C:\Dsc\Configurations"

Эта команда проверяет конфигурации, определенные в папке, указанной параметром Path . Конфигурации проверяются на нескольких компьютерах, каждый из которых идентифицируется по имени файла конфигурации.

Пример 5: Тестовые конфигурации, указанные в файле

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

Эта команда проверяет конфигурацию, определенную в файле, с набором компьютеров, указанным параметром ComputerName .

Параметры

-AsJob

Указывает, что этот командлет выполняет команду в качестве фонового задания.

Если указать параметр AsJob, команда возвращает объект, представляющий задание, а затем отображает командную строку. Вы можете продолжать работать в сеансе, пока задание не завершится. Задание создается на локальном компьютере, а результаты удаленных компьютеров автоматически возвращаются на локальный компьютер. Чтобы управлять заданием, используйте командлеты задания. Чтобы получить результаты задания, используйте командлет Receive-Job.

Чтобы использовать этот параметр, локальные и удаленные компьютеры должны быть настроены для удаленного взаимодействия, а также в Windows Vista и более поздних версиях операционной системы Windows, необходимо открыть Windows PowerShell с параметром "Запуск от имени администратора". Дополнительные сведения см. в about_Remote_Requirements.

Дополнительные сведения о фоновых заданиях Windows PowerShell см. в about_Jobs и about_Remote_Jobs.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-CimSession

Выполняет командлет в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные командлета Get-CimSession или Get-CimSession. По умолчанию используется текущий сеанс на локальном компьютере.

Свойства параметра

Тип:	CimSession[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

CimSessionAndPathSet

Position:	Named
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CimSessionAndReferenceConfigurationSet

Position:	Named
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CimSessionSet

Position:	Named
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ComputerName

Указывает массив имен компьютеров, на которых этот командлет проверяет конфигурацию. Командлет проверяет документ конфигурации в расположении, указанном параметром Path к этим компьютерам.

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	Китай, Имя сервера

Наборы параметров

ComputerNameSet

Position:	1
Обязательно:	False
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ComputerNameAndPathSet

Position:	1
Обязательно:	False
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ComputerNameAndReferenceConfigurationSet

Position:	1
Обязательно:	False
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Credential

Указывает имя пользователя и пароль в качестве объекта PSCredential для целевого компьютера. Чтобы получить объект PSCredential, используйте командлет.Get-Credential Для получения дополнительной информации введите Get-Help Get-Credential.

Свойства параметра

Тип:	PSCredential
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ComputerNameSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ComputerNameAndPathSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ComputerNameAndReferenceConfigurationSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Detailed

Указывает, что этот командлет возвращает подробный результат сравнения документа конфигурации с требуемым состоянием узлов. Результат включает в себя такие сведения, как общее состояние, ресурсы, которые находятся в требуемом состоянии, ресурсы, которые не находятся в нужном состоянии, и имя компьютера.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ComputerNameSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CimSessionSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Path

Указывает путь к папке, содержащей файлы документов конфигурации. Командлет проверяет конфигурацию на соответствие требуемому состоянию компьютеров, указанному в параметре ComputerName или CimSession .

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ComputerNameAndPathSet

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CimSessionAndPathSet

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ReferenceConfiguration

Указывает путь к файлу документа конфигурации. Этот командлет проверяет конфигурацию на соответствие фактическому состоянию компьютеров, указанному параметром ComputerName или CimSession .

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ComputerNameAndReferenceConfigurationSet

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CimSessionAndReferenceConfigurationSet

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ThrottleLimit

Указывает максимальное количество параллельных операций, которые можно установить для выполнения командлета. Если этот параметр опущен или введено значение 0, Windows PowerShell вычисляет оптимальное ограничение регулирования для командлета на основе количества командлетов CIM, работающих на компьютере. Ограничение регулирования применяется только к текущему командлету, а не к сеансу или к компьютеру.

Свойства параметра

Тип:	Int32
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Связанные ссылки

• Общие сведения о конфигурации требуемого состояния Windows PowerShell
• Get-DscConfiguration
• Get-DscConfigurationStatus
• Restore-DscConfiguration
• Start-DscConfiguration