Set-OnPremisesOrganization

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online, Exchange Online Protection

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Set-OnPremisesOrganization per modificare i parametri dell'oggetto OnPremisesOrganization nel tenant Microsoft 365.

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

Sintassi

Set-OnPremisesOrganization
   [-Identity] <OnPremisesOrganizationIdParameter>
   [-Comment <String>]
   [-Confirm]
   [-HybridDomains <MultiValuedProperty>]
   [-InboundConnector <InboundConnectorIdParameter>]
   [-OrganizationName <String>]
   [-OrganizationRelationship <OrganizationRelationshipIdParameter>]
   [-OutboundConnector <OutboundConnectorIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

L'oggetto OnPremisesOrganization rappresenta un'organizzazione di Exchange locale configurata per la distribuzione ibrida con un'organizzazione Microsoft 365. In genere, questo oggetto viene modificato e aggiornato solo dalla configurazione guidata ibrida. La modifica manuale di questo oggetto può causare errori di configurazione della distribuzione ibrida; È pertanto consigliabile usare la configurazione guidata ibrida per aggiornare questo oggetto nell'organizzazione Microsoft 365.

È 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

Set-OnPremisesOrganization -Identity "ExchangeMail" -HybridDomains contoso.com, sales.contoso.com, legal.contoso.com

In questo esempio viene aggiunto un terzo legal.contoso.com di dominio all'oggetto ExchangeMail OnPremisesOrganization nell'organizzazione Microsoft 365, che dispone già dei domini contoso.com e sales.contoso.com.

Parametri

-Comment

Il parametro Comment consente di specificare un commento facoltativo. Se si specifica un valore che contiene degli spazi, è necessario racchiuderlo tra virgolette ("); ad esempio: "Questa è una nota per amministratori".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-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 Online, Exchange Online Protection

-HybridDomains

Il parametro HybridDomains consente di specificare i domini configurati nella distribuzione ibrida tra un'organizzazione Microsoft 365 e un'organizzazione di Exchange locale. I domini specificati in questo parametro devono corrispondere ai domini elencati nell'oggetto Active Directory HybridConfiguration per l'organizzazione di Exchange locale configurata dalla Configurazione guidata ibrida. È possibile elencare più domini separati da una virgola: ad esempio, "contoso.com, sales.contoso.com".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

Il parametro Identity consente di specificare l'identità dell'oggetto dell'organizzazione locale. È possibile utilizzare i seguenti valori:

  • Nome canonico
  • GUID
  • Nome
Type:OnPremisesOrganizationIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-InboundConnector

Il parametro InboundConnector specifica il nome del connettore in ingresso configurato nel servizio Microsoft Exchange Online Protection (EOP) per una distribuzione ibrida configurata con un'organizzazione exchange locale.

Type:InboundConnectorIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-OrganizationName

Il parametro OrganizationName specifica il nome dell'oggetto Active Directory dell'organizzazione di Exchange locale.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-OrganizationRelationship

Il parametro OrganizationRelationship consente di specificare la relazione organizzativa configurata dalla configurazione guidata ibrida nell'organizzazione Microsoft 365 come parte di una distribuzione ibrida con un'organizzazione di Exchange locale. Questa relazione organizzativa definisce le funzionalità di condivisione federata abilitate nell'organizzazione Microsoft 365.

Type:OrganizationRelationshipIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-OutboundConnector

Il parametro OutboundConnector specifica il nome del connettore in uscita configurato nel servizio EOP per una distribuzione ibrida configurata con un'organizzazione di Exchange locale.

Type:OutboundConnectorIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-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 Online, Exchange Online Protection

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.