Get-AdministrativeUnit

Questo cmdlet funziona solo nel servizio basato sul cloud.

Usare il cmdlet Get-AdministrativeUnit per visualizzare le unità amministrative, ovvero i contenitori di risorse di Azure Active Directory. È possibile utilizzare le unità amministrative per delegare autorizzazioni amministrative e per applicare criteri a gruppi di utenti diversi.

Nota: le unità amministrative sono disponibili solo in Azure Active Directory Premium. È possibile creare e gestire unità amministrative in Microsoft Graph PowerShell.

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

Sintassi

Get-AdministrativeUnit
   [[-Identity] <AdministrativeUnitIdParameter>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

È 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-AdministrativeUnit

Questo esempio restituisce un elenco riepilogativo di tutte le unità amministrative di Azure Active Directory.

Esempio 2

Get-AdministrativeUnit -Identity "West Coast" | Format-List

Questo esempio restituisce informazioni dettagliate sull'unità amministrativa con nome visualizzato West Coast.

Parametri

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

Questo parametro è disponibile solo in Exchange locale.

Questo parametro è riservato all'uso interno da parte di Microsoft.

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

-Identity

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

  • Nome visualizzato (questo valore è lo stesso in Microsoft Graph PowerShell)
  • ExternalDirectoryObjectId (questo valore GUID è lo stesso della proprietà ObjectId in Microsoft Graph PowerShell)
  • Nome (valore GUID)
  • Nome distinto (DN)
  • GUID (valore diverso da Nome)
Type:AdministrativeUnitIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection