Rename-GPWmiFilter

NAME Rename-GPWmiFilter



SYNOPSIS

Get a WMI filter in current domain and rename it





SYNTAX

Rename-GPWmiFilter [-Name] <String[]> [-NewName] <String> [-PassThru] [-Server <String>] [-Credential

<PSCredential>] [-EnableException] [-WhatIf] [-Confirm] [<CommonParameters>]



Rename-GPWmiFilter -Guid <Guid[]> [-NewName] <String> [-PassThru] [-Server <String>] [-Credential <PSCredential>]

[-EnableException] [-WhatIf] [-Confirm] [<CommonParameters>]





DESCRIPTION

The Rename-GPWmiFilter function query WMI filter in current domain with specific name or GUID and then change it

to a new name.





PARAMETERS

-Name <String[]>

The name of WMI filter you want to query out.



Required? true

Position? 1

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-Guid <Guid[]>

The guid of WMI filter you want to query out.



Required? true

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-NewName <String>

The new name of WMI filter.



Required? true

Position? 2

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-PassThru [<SwitchParameter>]

Output the renamed WMI filter instance with this switch.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-Server <String>

The server to contact.

Specify the DNS Name of a Domain Controller.



Required? false

Position? named

Default value $env:USERDNSDOMAIN

Accept pipeline input? false

Accept wildcard characters? false



-Credential <PSCredential>

The credentials to use to contact the targeted server.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-EnableException [<SwitchParameter>]

This parameters disables user-friendly warnings and enables the throwing of exceptions.

This is less user friendly, but allows catching exceptions in calling scripts.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

If this switch is enabled, no actions are performed but informational messages will be displayed that explain

what would happen if the command were to run.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

If this switch is enabled, you will be prompted for confirmation before executing any operations that change

state.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Rename-GPWmiFilter -Name 'Workstations' -NewName 'Client Machines'



Rename WMI filter "Workstations" to "Client Machines"











RELATED LINKS