New-OnPremisesOrganization

Riferimento

Modulo:: ExchangePowerShell

Si applica a:: Exchange Online, Exchange Online Protection

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet New-OnPremisesOrganization per creare un oggetto OnPremisesOrganization in un'organizzazione Microsoft 365.

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

Sintassi

New-OnPremisesOrganization
   [-Name] <String>
   -HybridDomains <MultiValuedProperty>
   -InboundConnector <InboundConnectorIdParameter>
   -OrganizationGuid <Guid>
   -OutboundConnector <OutboundConnectorIdParameter>
   [-Comment <String>]
   [-Confirm]
   [-OrganizationName <String>]
   [-OrganizationRelationship <OrganizationRelationshipIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

L'oggetto OnPremisesOrganization rappresenta un'organizzazione di Exchange Microsoft locale configurata per la distribuzione ibrida con un'organizzazione Microsoft 365. Viene utilizzato insieme alla procedura guidata per la configurazione ibrida e in genere viene creato automaticamente all'inizio della configurazione della distribuzione 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

New-OnPremisesOrganization -Name "ExchangeMail" -OrganizationGuid "a1bc23cb-3456-bcde-abcd-feb363cacc88" -HybridDomains contoso.com, sales.contoso.com -InboundConnector "Inbound to ExchangeMail" -OutboundConnector "Outbound to ExchangeMail"

In questo esempio viene creato l'oggetto OnPremisesOrganization ExchangeMail in un'organizzazione Microsoft 365 per i domini ibridi 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, Exchange Online Protection

-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 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:	True
Accept pipeline input:	False
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:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Name

Il parametro Name consente di specificare un nome descrittivo per l'oggetto organizzazione di Exchange locale nell'organizzazione Microsoft 365.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-OrganizationGuid

Il parametro OrganizationGuid specifica l'identificatore univoco globale (GUID) dell'oggetto organizzazione di Exchange locale nell'organizzazione Microsoft 365.

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

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

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

-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:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 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.