Проверяет и исправляет безопасный канал между локальным компьютером и его доменом.
Синтаксис
Test-ComputerSecureChannel [-Repair] [-Server <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
Описание
Командлет Test-ComputerSecureChannel проверяет, правильно ли функционирует защищенный канал между локальным компьютером и его доменом, путем проверки состояния его отношений доверия. Если произошел сбой подключения, можно попытаться восстановить его с помощью параметра Repair.
Командлет Test-ComputerSecureChannel возвращает значение "True", если безопасный канал функционирует правильно, и значение "False" в противном случае. Это позволяет использовать командлет в условных операторах в функциях и скриптах. Для получения более подробных результатов проверки используйте параметр Verbose.
Этот командлет работает во многом подобно программе NetDom.exe. И NetDom, и Test-ComputerSecureChannel используют для выполнения операций службу NetLogon.
Параметры
-Repair
Удаляет и затем снова создает безопасный канал, установленный службой NetLogon. С помощью этого параметра можно попытаться восстановить соединение, которое не прошло проверку (возвратило значение "False".)
Для использования этого параметра текущий пользователь должен быть членом группы "Администраторы" на локальном компьютере.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
нет |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Server <string>
Использует для выполнения команды указанный контроллер домена. Если этот параметр опущен, Test-ComputerSecureChannel выбирает для операции контроллер домена по умолчанию.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
нет |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Confirm
Запрашивает подтверждение перед выполнением команды.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-WhatIf
Описывает, что произойдет при выполнении команды, без ее фактического выполнения.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
Нет Передать входные данные этому командлету по конвейеру невозможно. |
|
Выходные данные |
System.Boolean Командлет возвращает значение "True", если соединение функционирует правильно, и "False" в противном случае. |
Примечания
Чтобы использовать командлет Test-ComputerSecureChannel в Windows Vista и более поздних версиях Windows, необходимо запускать Windows PowerShell командой "Запуск от имени администратора".
Командлет Test-ComputerSecureChannel реализован с использованием функции I_NetLogonControl2, управляющей различными аспектами службы Netlogon.
Пример 1
C:\PS>test-computersecurechannel True Описание ----------- Эта команда проверяет безопасный канал между локальным компьютером и доменом, к которому он присоединен.
Пример 2
C:\PS>test-computersecurechannel -server DCName.fabrikam.com True Описание ----------- Эта команда задает предпочтительный контроллер домена для проверки.
Пример 3
C:\PS>Test-ComputerSecureChannel -repair True Описание ----------- Эта команда восстанавливает безопасный канал между локальным компьютером и его доменом.
Пример 4
C:\PS>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." Описание ----------- В этой команде используется общий параметр Verbose для запроса подробных сообщений о выполняемой операции. Дополнительные сведения о параметре Verbose см. в разделе about_CommonParameters.
Пример 5
C:\PS>set-alias tcsc test-computersecurechannel
if (!(tcsc))
{write-host "Connection failed. Reconnect and retry."}
else { &(.\get-servers.ps1) }
Описание
-----------
В этом примере показано, как с помощью командлета Test-ComputerSecureChannel проверить соединение, прежде чем выполнять скрипт, которому требуется соединение.
Первая команда с помощью командлета Set-Alias создает псевдоним для имени командлета. Это экономит место и позволяет избежать опечаток.
Инструкция IF проверяет возвращенное командлетом Test-ComputerSecureChannel значение, прежде чем выполнить скрипт.
См. также