Get-OrganizationalUnit

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Utilizzare il cmdlet Get-OrganizationalUnit per visualizzare un elenco delle unità organizzative (OU) presenti nell'organizzazione.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Get-OrganizationalUnit
   [[-Identity] <ExtendedOrganizationalUnitIdParameter>]
   [-SingleNodeOnly]
   [-DomainController <Fqdn>]
   [-IncludeContainers]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-OrganizationalUnit
   [-SearchText <String>]
   [-DomainController <Fqdn>]
   [-IncludeContainers]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-OrganizationalUnit viene usato dall'interfaccia di amministrazione di Exchange per popolare i campi che visualizzano informazioni sull'unità organizzativa.

È 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

Get-OrganizationalUnit "North America" -SingleNodeOnly | Format-Table Name, DistinguishedName

In questo esempio viene recuperato un elenco delle unità organizzative figlio di primo livello sotto l'unità organizzativa Nord America e l'output viene formattato in modo da visualizzare solo le proprietà Name e DistinguishedName.

Per altre informazioni sul pipelining e sul cmdlet Format-Table, vedere Informazioni sulle pipeline e Uso dell'output dei comandi.

Esempio 2

Get-OrganizationalUnit -SearchText "Executives" | Format-Table Name, DistinguishedName

In questo esempio viene recuperato un elenco delle unità organizzative che contengono la stringa "Executives" e l'output viene formattato in modo da visualizzare solo le proprietà Name e DistinguishedName.

Per altre informazioni sul pipelining e sul cmdlet Format-Table, vedere Informazioni sulle pipeline e Uso dell'output dei comandi.

Parametri

-DomainController

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

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

-Identity

Il parametro Identity consente di specificare l'unità organizzativa o il dominio che si desidera visualizzare. È possibile utilizzare qualsiasi valore che identifichi l'unità organizzativa o il dominio in modo univoco. Ad esempio:

  • Nome
  • Nome
  • Nome distinto (DN)
  • GUID

È possibile utilizzare tale parametro con il parametro SearchText.

Type:ExtendedOrganizationalUnitIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeContainers

L'opzione IncludeContainers consente al comando di restituire i contenitori nei risultati. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
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, Exchange Online

-ResultSize

Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SearchText

Il parametro SearchText permette di cercare i nomi di tutte le unità organizzative dell'organizzazione che contengono la stringa specificata. Vengono restituite solo le unità organizzative che corrispondono alla stringa specificata. Se la stringa specificata contiene spazi, racchiuderla tra virgolette (").

Non è possibile utilizzare questo parametro con il parametro Identity.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SingleNodeOnly

L'opzione SingleNodeOnly indica al comando di restituire solo le unità organizzative figlio di primo livello sotto l'unità organizzativa specificata nel parametro Identity. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
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, Exchange Online

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.