New-OnPremisesOrganization
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.