Get-DomainController
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet Get-DomainController per visualizzare un elenco di controller di dominio presenti all'interno dell'organizzazione.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-DomainController
[-GlobalCatalog]
[-Forest <Fqdn>]
[-Credential <NetworkCredential>]
[<CommonParameters>]
Get-DomainController
[-DomainName <Fqdn>]
[-Credential <NetworkCredential>]
[<CommonParameters>]
Descrizione
Il cmdlet Get-DomainController viene usato dall'interfaccia di amministrazione di Exchange per popolare i campi che visualizzano le informazioni sul controller di dominio.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.
Esempio
Esempio 1
$UserCredentials = Get-Credential
Get-DomainController -DomainName corp.contoso.com -Credential $UserCredentials | Format-Table -AutoSize Name,ADSite
In questo esempio, viene recuperato un elenco di server di catalogo globale nel dominio corp.contoso.com. Poiché per accedere a questo dominio è necessario un set di credenziali diverso, viene usato il cmdlet Get-Credential per ottenere il nome utente e la password dall'utente.
Il primo comando visualizza un prompt all'utente che accetta il nome utente e la password. Le credenziali vengono quindi memorizzate nella variabile $UserCredentials. Il secondo comando usa la variabile $UserCredentials per il valore del parametro Credential. Per rendere più leggibile l'elenco, l'output viene reindirizzato al cmdlet Format-Table e vengono visualizzate solo le proprietà di Name e ADSite.
Per altre informazioni sul pipelining e sul cmdlet Format-Table, vedere Informazioni sulle pipeline e Uso dell'output dei comandi.
Parametri
-Credential
Il parametro Credential consente di specificare il nome utente e la password usati per eseguire questo comando. In genere questo parametro viene utilizzato negli script o quando occorre fornire credenziali diverse con le autorizzazioni necessarie.
Questo parametro richiede la creazione e il passaggio di un oggetto credenziale. L'oggetto credenziale viene creato utilizzando il cmdlet Get-Credential. Per altre informazioni, vedere Get-Credential.
Se si utilizza il parametro Forest, le credenziali vengono utilizzate per accedere alla foresta.
Type: | NetworkCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainName
Il parametro DomainName consente di specificare il nome di dominio completo (FQDN) del dominio per il quale si desidera restituire un elenco di controller di dominio.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Forest
Il parametro Forest consente di specificare l'FQDN del dominio principale della foresta per cui si desidera restituire un elenco di controller di dominio.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GlobalCatalog
L'opzione GlobalCatalog consente di specificare se il comando deve restituire un elenco di server di catalogo globale. Con questa opzione non è necessario specificare alcun valore.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.