Remove-DhcpServerv4MulticastScope
Remove-DhcpServerv4MulticastScope
Removes multicast scopes.
語法
Parameter Set: Remove2
Remove-DhcpServerv4MulticastScope -Name <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-Force] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細描述
The Remove-DhcpServerv4MulticastScope cmdlet removes the specified multicast scopes from the Dynamic Host Configuration Protocol (DHCP) server. When you remove a multicast scope, the DHCP server cannot assign the range of IP addresses to DHCP clients.
參數
-AsJob
別名 |
無 |
必要? |
false |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-CimSession<CimSession[]>
在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件,例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。預設為本機電腦上的目前工作階段。
別名 |
Session |
必要? |
false |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-ComputerName<String>
Specifies the DNS name or IP address of the target computer that runs the DHCP Server service.
別名 |
Cn |
必要? |
false |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-Force
強制命令執行而不要求使用者確認。
If you specify this parameter, the cmdlet removes the scope regardless if there are active leases in the scope.
別名 |
無 |
必要? |
false |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-Name<String[]>
Specifies an array of names of multicast scopes.
別名 |
無 |
必要? |
true |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
True (ByPropertyName) |
接受萬用字元? |
false |
-PassThru
將表示您正在使用的項目的物件傳回。根據預設,此 Cmdlet 不會產生任何輸出。
別名 |
無 |
必要? |
false |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-ThrottleLimit<Int32>
指定為執行此 Cmdlet 可建立的最大同時作業數。如果省略這個參數或輸入 0
的值,則 Windows PowerShell® 會根據在電腦上執行的 CIM Cmdlet 數目,計算 Cmdlet 的最佳節流限制。節流限制僅適用於目前 Cmdlet,不適用於工作階段或電腦。
別名 |
無 |
必要? |
false |
位置? |
named |
預設值 |
無 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-Confirm
執行 Cmdlet 之前先提示您確認。
必要? |
false |
位置? |
named |
預設值 |
false |
接受管線輸入? |
false |
接受萬用字元? |
false |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。
必要? |
false |
位置? |
named |
預設值 |
false |
接受管線輸入? |
false |
接受萬用字元? |
false |
<CommonParameters>
此 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 與 -OutVariable。如需詳細資訊,請參閱 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
輸入
輸入類型是您可以使用管線處理方式傳遞給 Cmdlet 的物件類型。
輸出
輸出類型是 Cmdlet 所發出的物件類型。
範例
Example 1: Remove a multicast scope by using a name
This command removes the multicast scope named Multicast_VideoConference from the DHCP server named DhcpServer01.Contoso.com.
PS C:\> Remove-DhcpServerv4MulticastScope -Name "Multicast_VideoConference" -ComputerName "DhcpServer01.Contoso.com"
Example 2: Remove a multicast scope without a confirmation
This command removes the multicast scope named Multicast_AudioConference from the DHCP server named DhcpServer01.Contoso.com. The cmdlet does not prompt the user for confirmation, regardless if the scopes are active or contain active client leases.
PS C:\> Remove-DhcpServerv4MulticastScope -Name "Multicast_AudioConference" -ComputerName "DhcpServer01.Contoso.com" -Force
Example 3: Remove inactive multicast scopes
This command removes all of the disabled multicast scopes on the DHCP Server service. The Get-DhcpServerv4MulticastScope cmdlet returns the multicast scope objects and passes the objects to the Where-Object cmdlet by using the pipeline operator. For more information, type Get-Help Where-Object
.
The Where-Object cmdlet filters the multicast scope objects for inactive multicast scopes, and passes the objects to the Remove-DhcpServerv4MulticastScope cmdlet by using the pipeline operator. The Remove-DhcpServerv4MulticastScope cmdlet removes the inactive scopes.
PS C:\> Get-DhcpServerv4MulticastScope | Where-Object -FilterScript { $_.State -Eq "Inactive" } | Remove-DhcpServerv4MulticastScope -Force -PassThru
相關主題
Get-DhcpServerv4MulticastScope
Set-DhcpServerv4MulticastScope