Add-DnsServerZoneScope

Add-DnsServerZoneScope

Adds a zone scope to an existing zone.

構文

Parameter Set: Add0
Add-DnsServerZoneScope [-ZoneName] <String> [-Name] <String> [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-LoadExisting] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

詳細説明

The Add-DnsServerZoneScope cmdlet adds a zone scope to an existing zone on the Domain Name System (DNS) server. A DNS server can load an existing scope its data file. The name of the scope should adhere to the same conventions as the zone name. The scope name cannot be same as the zone name to which this cmdlet adds it.

When a scope is created, its data is persisted in a file named %Systemroot%\system32\dns\<zone name>\<scope name>.dns.

パラメーター

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。コンピューター名またはセッション オブジェクト (New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など) を入力します。既定値は、ローカル コンピューター上の現在のセッションです。

-ComputerName<String>

Specifies a remote DNS server. You can specify an IP address or any value that resolves to an IP address, such as a fully qualified domain name (FQDN), host name, or NETBIOS name.

-InformationAction<System.Management.Automation.ActionPreference>

-InformationVariable<System.String>

-LoadExisting

Indicates that the server loads an existing file for the zone. If you do not specify this parameter, the cmdlet creates default zone records automatically.

-Name<String>

Specifies a name for the zone scope.

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットから出力は生成されません。

-ThrottleLimit<Int32>

コマンドレットを実行する際に確立できる同時実行操作の最大数を指定します。このパラメーターを省略するか、値 0 を入力した場合、コンピューター上で実行されている CIM コマンドレットの数に基づいて、コマンドレットに最適なスロットル制限が Windows PowerShell® によって計算されます。スロットル制限は、セッションやコンピューターではなく、現在のコマンドレットにのみ適用されます。

-ZoneName<String>

Specifies the name of a zone. This cmdlet adds a zone to the zone that this parameter specifies.

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

-WhatIf

コマンドレットが実行された場合に何が起きるのかを示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「 「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。

<WorkflowParameters>

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

• Microsoft.Management.Infrastructure.CimInstance#DnsZoneScope

使用例

Example 1: Add a scope on a zone

This command adds a scope on an existing zone named contoso.com.

PS C:\> Add-DnsServerZoneScope -ZoneName "contoso.com" -Name "contoso_NorthAmerica" -Verbose -PassThru

Example 2: Add a scope on a zone with existing file

This command adds a scope on an existing zone named contoso.com. The command specifies the LoadExisting parameter, so the server loads the scope from an existing file.

PS C:\> Add-DnsServerZoneScope -ZoneName "contoso.com" -Name "contoso_NorthAmerica" -LoadExisting -PassThru 

Example 3: Add a cache scope

This command adds a cache scope named ContosoScope.

PS C:\> Add-DnsServerZoneScope -ZoneName "..cache" -Name "ContosoScope" -PassThru

関連項目

Get-DnsServerZoneScope

Remove-DnsServerZoneScope