Поделиться через

Test-ComputerSecureChannel

Модуль:
Microsoft.PowerShell.Management Module

Проверяет и восстанавливает безопасный канал между локальным компьютером и его доменом.

Синтаксис

Default (По умолчанию) 

Test-ComputerSecureChannel
    [-Repair]
    [-Server <String>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет Test-ComputerSecureChannel проверяет правильность работы канала между локальным компьютером и его доменом, проверяя состояние отношений доверия. Если подключение завершается ошибкой, можно использовать параметр восстановления, чтобы попытаться восстановить его.

Test-ComputerSecureChannel возвращает $true, если канал работает правильно и $false, если это не так. Этот результат позволяет использовать командлет в условных инструкциях в функциях и сценариях. Чтобы получить более подробные результаты теста, используйте параметр Подробные.

Этот командлет работает так же, как NetDom.exe. NetDom и Test-ComputerSecureChannel используйте службу NetLogon для выполнения действий.

Замечание

Этот командлет работает только на компьютерах-членах домена. При запуске на контроллерах домена он возвращает ложные положительные ошибки. Чтобы проверить и сбросить безопасные каналы для контроллеров домена, используйте netdom.exe или nltest.exe.

Примеры

Пример 1. Тестирование канала между локальным компьютером и его доменом

Test-ComputerSecureChannel

Эта команда проверяет канал между локальным компьютером и доменом, к которому он присоединен.

Пример 2. Тестирование канала между локальным компьютером и контроллером домена

Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

Эта команда задает предпочтительный контроллер домена для теста.

Пример 3. Сброс канала между локальным компьютером и его доменом

Test-ComputerSecureChannel -Repair

Эта команда сбрасывает канал между локальным компьютером и его доменом.

Пример 4. Отображение подробных сведений о тесте

Test-ComputerSecureChannel -Verbose

VERBOSE: Performing operation "Test-ComputerSecureChannel" on Target "SERVER01".
True
VERBOSE: "The secure channel between 'SERVER01' and 'net.fabrikam.com' is alive and working correctly."

Эта команда использует подробный общий параметр для запроса подробных сообщений об операции. Дополнительные сведения о подробных сведениях см. в about_CommonParameters.

Пример 5. Проверка подключения перед запуском скрипта

if (!(Test-ComputerSecureChannel)) {
    Write-Host "Connection failed. Reconnect and retry."
}
else {
    &(.\Get-Servers.ps1)
}

В этом примере показано, как протестировать Test-ComputerSecureChannel подключение перед запуском скрипта, требующего подключения.

Инструкция if проверяет значение, возвращаемое Test-ComputerSecureChannel перед запуском скрипта.

Параметры

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

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

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

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

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

-Credential

Указывает учетную запись пользователя, которая имеет разрешение на выполнение этого действия. Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential, например объект, возвращаемый командлетом Get-Credential. По умолчанию командлет использует учетные данные текущего пользователя.

Параметр учетных данных предназначен для использования в командах, использующих параметр repair для восстановления канала между компьютером и доменом.

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

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

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

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

-Repair

Указывает, что этот командлет удаляет и перестраивает канал, установленный службой NetLogon. Используйте этот параметр, чтобы попытаться восстановить подключение, которое завершилось сбоем теста.

Чтобы использовать этот параметр, текущий пользователь должен быть членом группы "Администраторы" на локальном компьютере.

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

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

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

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

-Server

Указывает контроллер домена для выполнения команды. Если этот параметр не указан, этот командлет выбирает контроллер домена по умолчанию для операции.

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

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

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

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

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не выполняется.

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

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

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

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

CommonParameters

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

Входные данные

None

Входные данные в этот командлет невозможно передать.

Выходные данные

Boolean

Этот командлет возвращает значение $true , если подключение работает правильно и $false если оно не работает.

Примечания

  • Чтобы выполнить Test-ComputerSecureChannel команду в Windows Vista и более поздних версиях операционной системы Windows, откройте Windows PowerShell с помощью параметра "Запуск от имени администратора".
  • Test-ComputerSecureChannel реализуется с помощью функции I_NetLogonControl2 , которая управляет различными аспектами службы Netlogon.