Set-IpamAccessScope

Configures an IPAM access scope.

Syntax

Set-IpamAccessScope
   [-IpamAddressSpace]
   [-AccessScopePath <String>]
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Confirm]
   -InputObject <CimInstance[]>
   [-IsInheritedAccessScope]
   [-PassThru]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-IpamAccessScope
   [-IpamBlock]
   [-AccessScopePath <String>]
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Confirm]
   -InputObject <CimInstance[]>
   [-IsInheritedAccessScope]
   [-PassThru]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-IpamAccessScope
   [-IpamDhcpScope]
   [-AccessScopePath <String>]
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Confirm]
   -InputObject <CimInstance[]>
   [-IsInheritedAccessScope]
   [-PassThru]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-IpamAccessScope
   [-IpamDhcpServer]
   [-AccessScopePath <String>]
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Confirm]
   -InputObject <CimInstance[]>
   [-IsInheritedAccessScope]
   [-PassThru]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-IpamAccessScope
   [-IpamDhcpSuperscope]
   [-AccessScopePath <String>]
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Confirm]
   -InputObject <CimInstance[]>
   [-IsInheritedAccessScope]
   [-PassThru]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-IpamAccessScope
   [-IpamDnsConditionalForwarder]
   [-AccessScopePath <String>]
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Confirm]
   -InputObject <CimInstance[]>
   [-IsInheritedAccessScope]
   [-PassThru]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-IpamAccessScope
   [-IpamDnsResourceRecord]
   [-AccessScopePath <String>]
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Confirm]
   -InputObject <CimInstance[]>
   [-IsInheritedAccessScope]
   [-PassThru]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-IpamAccessScope
   [-IpamDnsServer]
   [-AccessScopePath <String>]
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Confirm]
   -InputObject <CimInstance[]>
   [-IsInheritedAccessScope]
   [-PassThru]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-IpamAccessScope
   [-IpamDnsZone]
   [-AccessScopePath <String>]
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Confirm]
   -InputObject <CimInstance[]>
   [-IsInheritedAccessScope]
   [-PassThru]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-IpamAccessScope
   [-IpamRange]
   [-AccessScopePath <String>]
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Confirm]
   -InputObject <CimInstance[]>
   [-IsInheritedAccessScope]
   [-PassThru]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-IpamAccessScope
   [-IpamSubnet]
   [-AccessScopePath <String>]
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Confirm]
   -InputObject <CimInstance[]>
   [-IsInheritedAccessScope]
   [-PassThru]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [<CommonParameters>]

Description

The Set-IpamAccessScope configures an IP Address Management (IPAM) server access scope. Access scopes are used to manage permissions to IPAM objects such as Domain Name System (DNS) servers, Dynamic Host Configuration Protocol (DHCP) scopes, IP address ranges, etc..

When you install IPAM a global scope is automatically created for you. By default, users with permissions to the global scope have access to all the items in the IPAM infrastructure. To provide more control over access permissions you can create subscopes such as a geographic location or job role. You can use the Set-IpamAccessScope cmdlet to assign access scopes to specific IPAM objects.

The IPAM objects on which the access scope is to be set is provided in InputObject parameter.

Examples

Example 1: Configure an access scope

PS C:\> $Zone = Get-IpamDnsZone -ZoneType Forward -ZoneName "dublin.contoso.com"
PS C:\> Set-IpamAccessScope -IpamDnsZone -InputObject $Zone -AccessScopePath "\Global\Europe" -PassThru

The first command gets the IPAM DNS zone named dublin.contoso.com and stores it in the variable named $Zone. The second command adds DHCP scopes and superscopes to the access scope Global\Europe.

The command includes the PassThru parameter, so it displays results to the console.Universal Time Coordinate

Required Parameters

-InputObject

Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet.

Type:CimInstance[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IpamAddressSpace

Indicates that the access scope is assigned to the IPAM address space object. An address space contains IP blocks, IP subnets, IP ranges, and IP addresses.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IpamBlock

Indicates that the access scope is assigned to the IP address block object. An IP address block is the largest unit used for address space management, and is comprised of smaller units called IP address ranges.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IpamDhcpScope

Indicates that the access scope is assigned to the DHCP scope object.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IpamDhcpServer

Indicates that the access scope is assigned to DHCP servers.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IpamDhcpSuperscope

Indicates that the access scope is assigned to DHCP superscopes.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IpamDnsConditionalForwarder

Indicates that the access scope is assigned to DNS conditional forwarders.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IpamDnsResourceRecord

Indicates that the access scope is assigned to DNS resource records.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IpamDnsServer

Indicates that the access scope is assigned to DNS servers.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IpamDnsZone

Indicates that the access scope is assigned to DNS zones.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IpamRange

Indicates that the access scope is assigned to IPv4 or IPv6 address ranges. Address ranges are collections of IP addresses based on characteristics such as address family and starting/ending addresses.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IpamSubnet

Indicates that the access scope is assigned to IP subnets.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AccessScopePath

Specifies the path to the access scope. All access scopes must be children of the global scope.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AsJob

Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.

The cmdlet immediately returns an object that represents the job and then displays the command prompt. You can continue to work in the session while the job completes. To manage the job, use the *-Job cmdlets. To get the job results, use the Receive-Job cmdlet.

For more information about Windows PowerShell background jobs, see about_Jobs.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CimSession

The acceptable values for this parameter are:

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-IsInheritedAccessScope

Indicates that the input object is assigned to the access scope of its parent object. For example, if the input object is DNS resource record, its access scope will be set to the access scope of the DNS zone the resource record is part of.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ThrottleLimit

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False