Test-CsGroupExpansion
Ultima modifica dell'argomento: 2012-03-27
Verifica la capacità di un utente di ricorrere all'espansione dei gruppi. Microsoft Lync Server 2010 consente all'utente di configurare un gruppo di distribuzione di Active Directory come contatto. Quando si espande un gruppo, vengono visualizzati il nome e le informazioni sulla presenza per ciascun membro del gruppo.
Sintassi
Test-CsGroupExpansion -TargetFqdn <String> -GroupEmailAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsGroupExpansion -GroupEmailAddress <String> -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]
Test-CsGroupExpansion [-TargetFqdn <String>] -GroupEmailAddress <String> -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrizione dettagliata
Può accadere che gli utenti a volte abbiano necessità di comunicare regolarmente con tutti i membri di un gruppo di distribuzione di Active Directory, ad esempio perché tale gruppo include tutti i membri di un team o tutte le persone assegnate a un determinato progetto. Lync Server 2010 consente pertanto di configurare come contatto un gruppo di distribuzione. Eseguendo tale operazione, è possibile inviare lo stesso messaggio istantaneo a tutti i membri del gruppo semplicemente indirizzando il messaggio al gruppo anziché a ciascun singolo membro del gruppo.
Potrebbero ovviamente anche esservi occasioni in cui è necessario comunicare con (o verificare la presenza di) determinati individui di tale gruppo. l'espansione dei gruppi consente di visualizzare in modo semplice e rapido tutti i membri di un gruppo e il relativo stato corrente. È inoltre possibile selezionare uno o più membri del gruppo e inviare un messaggio istantaneo solo a tali utenti anziché a tutti i membri.
l'espansione dei gruppi viene abilitata e disabilitata utilizzando il cmdlet Set-CsWebServiceConfiguration. Se l'espansione dei gruppi è abilitata, sarà possibile determinare se funziona correttamente eseguendo il cmdlet Test-CsGroupExpansion. Con questo cmdlet, si specifica un gruppo di distribuzione di Active Directory utilizzando il relativo indirizzo di posta elettronica. Test-CsGroupExpansion quindi utilizza la funzionalità di espansione dei gruppi per recuperare i membri del gruppo e confrontare l'elenco recuperato con i membri dell'indirizzo di posta elettronica specificato. Se i due elenchi corrispondono, l'espansione dei gruppi sta funzionando correttamente.
Si noti che è possibile testare l'espansione dei gruppi in due modi diversi: testando il servizio stesso oppure testando il servizio Web associato.
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-CsGroupExpansion"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
GroupEmailAddress |
Obbligatorio |
Stringa |
l'indirizzo di posta elettronica del gruppo di distribuzione di destinazione. Ad esempio: -GroupEmailAddress "FinanceGroup@litwareinc.com". |
External |
Facoltativo |
Parametro opzionale |
Consente di verificare se gli utenti esterni possono utilizzare l'espansione dei gruppi. |
RegistrarPort |
Numero intero |
Stringa |
Porta SIP utilizzata dal servizio di registrazione. Questo parametro non è necessario se il servizio di registrazione utilizza la porta predefinita 5061. |
TargetFqdn |
Facoltativo |
Stringa |
Nome di dominio completo (FQDN) del pool di registrazione in cui testare l'espansione dei gruppi. Ad esempio: -TargetFqdn "atl-cs-001.litwareinc.com". Si noti che non è possibile utilizzare il parametro TargetUri e il parametro TargetFqdn nello stesso comando. |
TargetUri |
Facoltativo |
Stringa |
URI (Uniform Resource Identifier) del servizio Web per l'espansione dei gruppi. Ad esempio: -TargetUri "https://atl-cs-001.litwareinc.com/groupexpansion". Si noti che non è possibile utilizzare il parametro TargetUri e il parametro TargetFqdn nello stesso comando. |
UserCredential |
Facoltativo |
Oggetto credenziale PS |
l'oggetto credenziale utente per l'account utente da utilizzare nel test. Il valore passato a UserCredential deve essere un riferimento oggetto ottenuto utilizzando il cmdlet Get-Credential. Ad esempio, con il codice seguente viene restituito un oggetto credenziale per l'utente litwareinc\davidegarghentini e tale oggetto viene archiviato in una variabile denominata $x: $x = Get-Credential "litwareinc\davidegarghentini" È necessario fornire la password utente quando si esegue questo comando. La credenziale utente non è richiesta se si esegue il test con le credenziali dell'utente connesso e utilizzando il parametro TargetFqdn. La credenziale utente è obbligatoria se si utilizza il parametro TargetUri. |
UserSipAddress |
Facoltativo |
Stringa |
Indirizzo SIP dell'utente da utilizzare nel test. Se questo parametro non viene specificato, Test-CsGroupExpansion eseguirà le proprie verifiche utilizzando l'account dell'utente connesso. |
WebCredential |
Facoltativo |
Oggetto credenziali PS |
Oggetto contenente le credenziali utente per l'accesso al servizio Informazioni percorso. Questo oggetto può essere recuperato chiamando il cmdlet Get-Credential e specificando le credenziali appropriate. Questo parametro è obbligatorio se sono stati specificati i parametri TargetUri e UserSipAddress e se il computer in cui viene eseguito il comando non dispone di un certificato del server. |
Force |
Facoltativo |
Parametro opzionale |
Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando. |
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. |
Verbose |
Facoltativo |
GUID |
Consente di segnalare l'attività dettagliata sullo schermo durante l'esecuzione del cmdlet. |
Tipi di input
Nessuno. Test-CsGroupExpansion non accetta l'input da pipeline.
Tipi restituiti
Test-CsGroupExpansion restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsGroupExpansion -TargetFqdn atl-cs-001.litwareinc.com -GroupEmailAddress FinanceGroup@litwareinc.com
Il comando mostrato nell'esempio 1 esegue la connessione al pool di registrazione atl-cs-001.litwareinc.com per verificare l'espansione dei gruppi. Per eseguire il test, nel comando viene utilizzato il gruppo FinanceGroup@litwareinc.com.