Invoke-FreeIPAAPIidrange_add

NAME Invoke-FreeIPAAPIidrange_add



SYNOPSIS





SYNTAX

Invoke-FreeIPAAPIidrange_add [-base_id] <Int32> [-range_size] <Int32> [[-rid_base] <Int32>] [[-secondary_rid_base]

<Int32>] [[-dom_sid] <String>] [[-dom_name] <String>] [[-type] <String>] [[-setattr] <String[]>] [[-addattr]

<String[]>] [-all] [-raw] [[-version] <String>] [-name] <String> [-FullResultsOutput] [<CommonParameters>]





DESCRIPTION

Add new ID range.



To add a new ID range you always have to specify



-base-id

-range-size



Additionally



-rid-base

-secondary-rid-base



may be given for a new ID range for the local domain while



-rid-base

-dom-sid



must be given to add a new range for a trusted AD domain.



=======

WARNING:



DNA plugin in 389-ds will allocate IDs based on the ranges configured for the

local domain. Currently the DNA plugin *cannot* be reconfigured itself based

on the local ranges set via this family of commands.



Manual configuration change has to be done in the DNA plugin configuration for

the new local range. Specifically, The dnaNextRange attribute of 'cn=Posix

IDs,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config' has to be

modified to match the new range.

=======





PARAMETERS

-base_id <Int32>

First Posix ID of the range



Required? true

Position? 1

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-range_size <Int32>

Number of IDs in the range



Required? true

Position? 2

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-rid_base <Int32>

First RID of the corresponding RID range



Required? false

Position? 3

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-secondary_rid_base <Int32>

First RID of the secondary RID range



Required? false

Position? 4

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-dom_sid <String>

Domain SID of the trusted domain



Required? false

Position? 5

Default value

Accept pipeline input? false

Accept wildcard characters? false



-dom_name <String>

Name of the trusted domain



Required? false

Position? 6

Default value

Accept pipeline input? false

Accept wildcard characters? false



-type <String>

ID range type, one of ipa-ad-trust, ipa-ad-trust-posix, ipa-local



Required? false

Position? 7

Default value

Accept pipeline input? false

Accept wildcard characters? false



-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? 8

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? 9

Default value

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? 10

Default value

Accept pipeline input? false

Accept wildcard characters? false



-name <String>

Range name



Required? true

Position? 11

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