Test-CsPhoneBootstrap
Ultima modifica dell'argomento: 2012-03-26
Verifica che un utente possa accedere a Microsoft Lync Server 2010 utilizzando un dispositivo compatibile con Microsoft Lync 2010 Phone Edition.
Sintassi
Test-CsPhoneBootstrap [-TargetFqdn <String>] -PhoneOrExt <String> -PIN <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetUri <String>] [-UserSipAddress <String>]
Descrizione dettagliata
Per poter effettuare la connessione a Lync Server 2010, i dispositivi compatibili con Lync 2010 Phone Edition devono utilizzare il protocollo DHCP (Dynamic Host Configuration Protocol) per recuperare l'indirizzo di un pool di registrazione di Lync Server. Questi dispositivi inoltre devono fornire un numero di telefono e un codice PIN associato validi per poter essere autenticati dal sistema. (Questo processo è noto come "bootstrap"). Il cmdlet Test-CsPhoneBootstrap consente agli amministratori di verificare che un dato utente che utilizza il numero di telefono e il codice PIN assegnato sia in grado di accedere al sistema da un dispositivo compatibile con Lync 2010 Phone Edition. Per eseguire il test tuttavia non è richiesto alcun dispositivo.
Per consentire al cmdlet Test-CsPhoneBootstrap di effettuare il controllo, il pool di registrazione che ospita l'account utente su cui viene eseguito il test deve risultare individuabile mediante protocollo DHCP. Per stabilire se è possibile individuare in questo modo un pool di registrazione, utilizzare il cmdlet Get-CsRegistrarConfiguration e controllare il valore della proprietà EnableDHCPServer. Se la proprietà è impostata su False, sarà necessario utilizzare Set-CsRegistrarConfiguration per impostare il valore su True in modo che il pool di registrazione risulti individuabile mediante protocollo DHCP. Questa operazione può essere eseguita anche utilizzando un server DHCP versione Enterprise e configurando le opzioni specifiche di Lync Server.
Utenti autorizzati a eseguire il cmdlet: per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPhoneBootstrap"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
PhoneOrExt |
Obbligatorio |
Stringa |
Numero di telefono o interno dell'account utente di cui viene eseguito il test. Ad esempio: -PhoneOrExt "+14255551219". |
PIN |
Obbligatorio |
Stringa |
Codice PIN dell'account utente su cui viene eseguito il test. |
RegistrarPort |
Facoltativo |
Numero intero |
La porta SIP utilizzata dal servizio di registrazione. Questo parametro non è obbligatorio se il servizio di registrazione utilizza la porta 5061 predefinita. |
TargetFqdn |
Facoltativo |
Stringa |
Nome di dominio completo (FQDN) del pool di registrazione che ospita l'account utente su cui eseguire il test. Se non viene specificato, verrà utilizzata l'individuazione tramite DHCP per trovare il pool di registrazione. |
TargetUri |
Facoltativo |
Stringa |
URL del servizio di provisioning del certificato. Se questo parametro non viene incluso, verrà utilizzata l'individuazione tramite DHCP per trovare l'URI di destinazione. |
UserSipAddress |
Facoltativo |
Stringa |
Indirizzo SIP dell'account utente utilizzato nel test, ad esempio -UserSipAddress "sip:davidegarghentini@litwareinc.com". Il parametro UserSIPAddress deve fare riferimento al numero di telefono e al codice PIN specificati. Il test avrà esito negativo se il numero di telefono e il codice PIN inclusi non appartengono all'utente specificato dal parametro UserSipAddress. Si noti che l'indirizzo SIP deve includere il prefisso "sip:". |
OutVerboseVariable |
Facoltativo |
Stringa |
Quando presente, l'output dettagliato relativo all'esecuzione del cmdlet verrà archiviato nella variabile specificata. Per archiviare, ad esempio, l'output in una variabile denominata $TestOutput, utilizzare la sintassi seguente: -OutVerboseVariable TestOutput Non anteporre un carattere $ quando si specifica il nome della variabile. |
Force |
Facoltativo |
Guid |
Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando. |
Verbose |
Facoltativo |
Stringa |
Consente di segnalare l'attività dettagliata sullo schermo durante l'esecuzione del cmdlet. |
Tipi di input
Nessuno. Test-CsPhoneBootstrap non accetta l'input da pipeline.
Tipi restituiti
Test-CsPhoneBootstrap restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 ------------------------
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712"
Il comando mostrato nell'esempio 1 verifica che l'utente con il numero di telefono e il codice PIN specificati possa connettersi a Lync Server utilizzando un dispositivo compatibile con Lync 2010 Phone Edition. Per eseguire il test, è necessario fornire il numero di telefono (+14255551219) e il codice PIN (0712) dell'utente.
-------------------------- Esempio 2 ------------------------
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712" -UserSipAddress "sip:kenmyer@litwareinc.com"
Il comando precedente verifica se l'utente con il numero di telefono e il codice PIN specificati è in grado di connettersi a Lync Server utilizzando un dispositivo compatibile con Lync 2010 Phone Edition. In questo esempio il parametro UserSipAddress viene incluso come verifica aggiuntiva: il test avrà esito negativo se l'utente con l'indirizzo SIP e l'utente con il numero di telefono e il codice PIN specificati non coincidono.