Set-Ipam
Access
Scope
Syntax
Set-IpamAccessScope
[-IpamRange]
[-AccessScopePath <String>]
[-IsInheritedAccessScope]
-InputObject <CimInstance[]>
[-PassThru]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-IpamAccessScope
[-AccessScopePath <String>]
[-IsInheritedAccessScope]
-InputObject <CimInstance[]>
[-PassThru]
[-IpamDnsServer]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-IpamAccessScope
[-AccessScopePath <String>]
[-IsInheritedAccessScope]
-InputObject <CimInstance[]>
[-PassThru]
[-IpamDhcpServer]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-IpamAccessScope
[-AccessScopePath <String>]
[-IsInheritedAccessScope]
-InputObject <CimInstance[]>
[-PassThru]
[-IpamDhcpSuperscope]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-IpamAccessScope
[-AccessScopePath <String>]
[-IsInheritedAccessScope]
-InputObject <CimInstance[]>
[-PassThru]
[-IpamDhcpScope]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-IpamAccessScope
[-AccessScopePath <String>]
[-IsInheritedAccessScope]
-InputObject <CimInstance[]>
[-PassThru]
[-IpamDnsConditionalForwarder]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-IpamAccessScope
[-AccessScopePath <String>]
[-IsInheritedAccessScope]
-InputObject <CimInstance[]>
[-PassThru]
[-IpamDnsResourceRecord]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-IpamAccessScope
[-AccessScopePath <String>]
[-IsInheritedAccessScope]
-InputObject <CimInstance[]>
[-PassThru]
[-IpamDnsZone]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-IpamAccessScope
[-AccessScopePath <String>]
[-IsInheritedAccessScope]
-InputObject <CimInstance[]>
[-PassThru]
[-IpamAddressSpace]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-IpamAccessScope
[-AccessScopePath <String>]
[-IsInheritedAccessScope]
-InputObject <CimInstance[]>
[-PassThru]
[-IpamSubnet]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-IpamAccessScope
[-AccessScopePath <String>]
[-IsInheritedAccessScope]
-InputObject <CimInstance[]>
[-PassThru]
[-IpamBlock]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<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
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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
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 |
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 |
The acceptable values for this parameter are:
Type: | CimSession[] |
Aliases: | Session |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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 |
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 |
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 |
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 |
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 |