Remove-CMDeviceCollectionVariable
移除裝置集合變數。
Syntax
Remove-CMDeviceCollectionVariable
-Collection <IResultObject>
[-Force]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionVariable
-CollectionId <String>
[-Force]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionVariable
-CollectionName <String>
[-Force]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 移除裝置集合變數。
預設集合不能有變數。 您目標的任何集合都應該有以月臺碼開頭的識別碼,而不是 SMS
。
如需詳細資訊,請 參閱如何設定工作順序變數。
注意事項
從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:移除裝置集合變數
第一個命令會取得名為 Device 的裝置集合物件,並將它儲存在 $Collection 變數中。
第二個命令會從儲存在 $Collection 變數中的裝置集合中移除名為testTS 的裝置集合變數。 指定 Force 參數表示在移除變數之前,不會提示您。
$Collection = Get-CMCollection -Name "Device"
Remove-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Force
範例 2:從裝置集合中移除所有變數
此範例會先使用 Get-CMDeviceCollectionVariable Cmdlet 來取得裝置集合 IT 伺服器 上的所有變數,並將物件儲存在 vars 數 組變數中。 然後,它會迴圈查看陣列中的每個專案,並依名稱移除變數。
使用 Force 參數時,系統不會提示您移除每個變數。
$collName = "IT servers"
$vars = Get-CMDeviceCollectionVariable -CollectionName $collName
foreach ( $var in $vars ) {
Remove-CMDeviceCollectionVariable -CollectionName $collName -VariableName $var -Force
}
由於 VariableName 參數不允許萬用字元,因此如果您需要快速清除裝置集合中的所有變數,請使用此程式。
參數
-Collection
指定要移除其變數的裝置集合物件。 若要取得此物件,請使用 Get-CMCollection 或 Get-CMDeviceCollection Cmdlet。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CollectionId
指定要移除其變數之裝置集合的識別碼。 這個值是CollectionID屬性,例如 。 XYZ00012
因為您無法在預設集合上設定變數,所以此值的開頭是月臺碼,而不是 SMS
。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
指定要移除其變數的裝置集合名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
強制命令在不要求使用者確認的情況下執行。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此參數會處理萬用字元,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VariableName
指定要移除之集合變數的名稱。 此參數不接受萬用字元。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應