Invoke-FreeIPAAPItrust_add

NAME Invoke-FreeIPAAPItrust_add



SYNOPSIS





SYNTAX

Invoke-FreeIPAAPItrust_add [[-setattr] <String[]>] [[-addattr] <String[]>] [[-type] <String>] [[-admin] <String>]

[[-password] <SecureString>] [[-server] <String>] [[-trust_secret] <SecureString>] [[-base_id] <Int32>]

[[-range_size] <Int32>] [[-range_type] <String>] [-two_way] [-external] [-all] [-raw] [[-version] <String>]

[-realm] <String> [-FullResultsOutput] [<CommonParameters>]





DESCRIPTION

Add new trust to use.



This command establishes trust relationship to another domain

which becomes 'trusted'. As result, users of the trusted domain

may access resources of this domain.



Only trusts to Active Directory domains are supported right now.



The command can be safely run multiple times against the same domain,

this will cause change to trust relationship credentials on both

sides.



Note that if the command was previously run with a specific range type,

or with automatic detection of the range type, and you want to configure a

different range type, you may need to delete first the ID range using

ipa idrange-del before retrying the command with the desired range type.





PARAMETERS

-setattr <String[]>

Set an attribute to a name/value pair. Format is attr=value.

For multi-valued attributes, the command replaces the values already present.



Required? false

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



-addattr <String[]>

Add an attribute/value pair. Format is attr=value. The attribute

must be part of the schema.



Required? false

Position? 2

Default value

Accept pipeline input? false

Accept wildcard characters? false



-type <String>

Trust type (ad for Active Directory, default)



Required? false

Position? 3

Default value

Accept pipeline input? false

Accept wildcard characters? false



-admin <String>

Active Directory domain administrator



Required? false

Position? 4

Default value

Accept pipeline input? false

Accept wildcard characters? false



-password <SecureString>

Active Directory domain administrator's password



Required? false

Position? 5

Default value

Accept pipeline input? false

Accept wildcard characters? false



-server <String>

Domain controller for the Active Directory domain (optional)



Required? false

Position? 6

Default value

Accept pipeline input? false

Accept wildcard characters? false



-trust_secret <SecureString>

Shared secret for the trust



Required? false

Position? 7

Default value

Accept pipeline input? false

Accept wildcard characters? false



-base_id <Int32>

First Posix ID of the range reserved for the trusted domain



Required? false

Position? 8

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-range_size <Int32>

Size of the ID range reserved for the trusted domain



Required? false

Position? 9

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-range_type <String>

Type of trusted domain ID range, one of ipa-ad-trust, ipa-ad-trust-posix



Required? false

Position? 10

Default value

Accept pipeline input? false

Accept wildcard characters? false



-two_way [<SwitchParameter>]

Establish bi-directional trust. By default trust is inbound one-way only.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-external [<SwitchParameter>]

Establish external trust to a domain in another forest. The trust is not transitive beyond the domain.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-all [<SwitchParameter>]

Retrieve and print all attributes from the server. Affects command output.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-raw [<SwitchParameter>]

Print entries as stored on the server. Only affects output format.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-version <String>

Client version. Used to determine if server will accept request.



Required? false

Position? 11

Default value

Accept pipeline input? false

Accept wildcard characters? false



-realm <String>

Realm name



Required? true

Position? 12

Default value

Accept pipeline input? false

Accept wildcard characters? false



-FullResultsOutput [<SwitchParameter>]



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

System.Management.Automation.PSObject







RELATED LINKS