Disable-AppvClientConnectionGroup

Letzte Aktualisierung: Dezember 2014

Betrifft: Application Virtualization 5.0, Application Virtualization 5.0 SP1, Application Virtualization 5.0 SP2, Application Virtualization 5.0 SP3

Disable-AppvClientConnectionGroup

Disables a connection group on the computer running the App-V client.

Syntax

Parameter Set: ByGuid
Disable-AppvClientConnectionGroup [-GroupId] <Guid> [-VersionId] <Guid> [-Global] [-UserSID <System.String> ] [ <CommonParameters>]

Parameter Set: ByConnectionGroup
Disable-AppvClientConnectionGroup [-ConnectionGroup] <AppvClientConnectionGroup> [-Global] [-UserSID <System.String> ] [ <CommonParameters>]

Parameter Set: ByName
Disable-AppvClientConnectionGroup [-Name] <String> [-Global] [-UserSID <System.String> ] [ <CommonParameters>]




Detaillierte Beschreibung

The Disable-AppvClientConnectionGroup cmdlet disables an already existing connection group on the computer running the Microsoft Application Virtualization (App-V) client.

Parameter

-ConnectionGroup<AppvClientConnectionGroup>

Not Specified.


Aliasse

none

Erforderlich?

true

Position?

1

Standardwert

none

Pipelineeingaben akzeptieren?

True (ByValue)

Platzhalterzeichen akzeptieren?

false

-Global

Specifies whether the provided connection group is disabled for all users that log into the target computer. Otherwise, the connection group is disabled only for the currently running user.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-GroupId<Guid>

Specifies the GUID associated with a specific connection group.


Aliasse

none

Erforderlich?

true

Position?

1

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Name<String>

Specifies the name of the App-V connection group.


Aliasse

none

Erforderlich?

true

Position?

1

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-UserSID<System.String>

Specifies the SID of the intended user, in the form of S-1-2-34-56789012-3456789012-345678901-2345. This parameter requires elevated rights to run.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-VersionId<Guid>

Specifies a GUID that differentiates the connection group version from other versions. If you do not specify this parameter, the cmdlet operates on all versions of the connection group.


Aliasse

none

Erforderlich?

true

Position?

2

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

  • Microsoft.AppvAgent.AppvClientConnectionGroup

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

Hinweise

  • The cmdlet checks that you have permissions to perform the specific action. If not, the cmdlet returns the following error: The action could not be performed due to current App-V permissions. Please modify the permissions and try the operation again.

  • If the disable operation fails, the cmdlet returns the following error: The disable operation could not be completed. An error code is returned.

  • If any package within the specified group is running, the connection group will not be disabled until all packages in the new group are shutdown. The cmdlet will still return success as long as the file is valid.

  • If the cmdlet cannot find the connection group, the cmdlet returns the following error: The specified connection group could not be found on the target system.

Beispiele

Example 1: Disable a connection group by using its name

This command disables the connection group named MyGroup.


PS C:\> Disable-AppvClientConnectionGroup -Name "MyGroup"

Example 2: Disable a connection group by using its ID

This command disables the connection group that has the group ID 35ec9e5f-ab21-463f-8fe6-b90d4b66d182.


PS C:\> Disable-AppvClientConnectionGroup -GroupID 35ec9e5f-ab21-463f-8fe6-b90d4b66d182

Example 3: Disable all connection groups by names that match a string

This command gets all the connection groups that have the string MyGr in the name, and then disables them.


PS C:\> Get-AppvClientConnectionGroup -Name "MyGr*" | Disable-AppvClientConnectionGroup

Verwandte Themen

Community-Beiträge

HINZUFÜGEN
Anzeigen: