Delen via


Set-CMAccessAccount

SYNOPSIS

Wijzigt de eigenschappen van een toegangsaccount.

SYNTAX

SearchByValue (standaard)

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> [-InputObject] <IResultObject>
 [-PassThru] [-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByApplicationId

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -ApplicationId <String> [-PassThru]
 [-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByApplicationName

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -ApplicationName <String>
 [-PassThru] [-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByBootImageId

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -BootImageId <String> [-PassThru]
 [-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByBootImageName

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -BootImageName <String> [-PassThru]
 [-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByDriverPackageId

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -DriverPackageId <String>
 [-PassThru] [-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByDriverPackageName

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -DriverPackageName <String>
 [-PassThru] [-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByOSImageId

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -OperatingSystemImageId <String>
 [-PassThru] [-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByOSImageName

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -OperatingSystemImageName <String>
 [-PassThru] [-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByOSInstallerId

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -OperatingSystemInstallerId <String>
 [-PassThru] [-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByOSInstallerName

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType>
 -OperatingSystemInstallerName <String> [-PassThru] [-UserName <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByPackageId

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -PackageId <String> [-PassThru]
 [-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByPackageName

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -PackageName <String> [-PassThru]
 [-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchBySoftwareUpdateDeploymentPackageId

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> [-PassThru]
 -SoftwareUpdateDeploymentPackageId <String> [-UserName <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchBySoftwareUpdateDeploymentPackageName

Set-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> [-PassThru]
 -SoftwareUpdateDeploymentPackageName <String> [-UserName <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

De cmdlet Set-CMAccessAccount wijzigt de eigenschappen van een toegangsaccount. U kunt gebruikers of groepen toevoegen aan het toegangsaccount en het machtigingsniveau wijzigen voor objecten waarvoor ze machtigingen hebben.

Een toegangsaccount is een lijst met gebruikers of groepen die toegang hebben tot een bestaande service of toepassing die zich op een distributiepunt bevindt. Leden van het verbindingsaccount voor software-updatepunt hebben bijvoorbeeld toegang tot twee services voor het beheren van software-updates: Windows Server Update Services (WSUS) en WSUS Synchronization Manager.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: de toegang tot een pakket wijzigen met behulp van de pakketnaam

PS XYZ:\> $Name = Get-CMAccessAccount -PackageName "Configuration Manager Client Package"
PS XYZ:\> Set-CMAccessAccount -PackageName $Name -Type User -UserName "CONTOSO\PFuller" -Access Read -Confirm

De eerste opdracht haalt de pakketnaam op en slaat deze vervolgens op in de $Name variabele.

Met de tweede opdracht stelt u toegangsmachtigingen voor de gebruiker voor het pakket in op Lezen. U moet de actie bevestigen voordat de opdracht deze uitvoert.

PARAMETERS

-Access

Hiermee geeft u de toegangsrechten op die zijn gekoppeld aan een toegangsaccount. Geldige waarden zijn: Geen toegang, Lezen, Wijzigen en Volledig beheer.

Type: AccessRight
Parameter Sets: (All)
Aliases:
Accepted values: NoAccess, Read, Change, FullControl

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AccountType

Hiermee geeft u een accounttype. Geldige waarden zijn: Guest, User, WindowsGroup en WindowsUser.

Type: AccessAccountType
Parameter Sets: (All)
Aliases:
Accepted values: User, Guest, Administrator, WindowsUser, WindowsGroup

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ApplicationId

Hiermee geeft u de id van een toepassing op.

Type: String
Parameter Sets: SearchByApplicationId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ApplicationName

Hiermee geeft u de naam van een toepassing op.

Type: String
Parameter Sets: SearchByApplicationName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-BootImageId

Hiermee geeft u de id van een opstartafbeelding.

Type: String
Parameter Sets: SearchByBootImageId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-BootImageName

Hiermee geeft u de naam van een opstartafbeelding.

Type: String
Parameter Sets: SearchByBootImageName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DriverPackageId

Hiermee geeft u de id van een stuurprogrammapakket.

Type: String
Parameter Sets: SearchByDriverPackageId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DriverPackageName

Hiermee geeft u de naam van een stuurprogrammapakket.

Type: String
Parameter Sets: SearchByDriverPackageName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Type: IResultObject
Parameter Sets: SearchByValue
Aliases: DriverPackage, Application, OperatingSystemImage, OperatingSystemInstaller, Package, SoftwareUpdateDeploymentPackage, BootImage

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-OperatingSystemImageId

Hiermee geeft u de id van een installatiesturingssysteeminstallatie op.

Type: String
Parameter Sets: SearchByOSImageId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OperatingSystemImageName

Hiermee geeft u de naam van een installatiesturingssysteeminstallatie op.

Type: String
Parameter Sets: SearchByOSImageName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OperatingSystemInstallerId

Hiermee geeft u de id van een installatieprogramma van een besturingssysteem op.

Type: String
Parameter Sets: SearchByOSInstallerId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OperatingSystemInstallerName

Hiermee geeft u de naam van een installatieprogramma voor het besturingssysteem op.

Type: String
Parameter Sets: SearchByOSInstallerName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PackageId

Hiermee geeft u de id van een geïmplementeerd softwarescript of -programma op.

Type: String
Parameter Sets: SearchByPackageId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PackageName

Hiermee geeft u de naam van een geïmplementeerd softwarescript of -programma op.

Type: String
Parameter Sets: SearchByPackageName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PassThru

Voeg deze parameter toe om een -object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SoftwareUpdateDeploymentPackageId

Hiermee geeft u de id van een geïmplementeerde software-update op.

Type: String
Parameter Sets: SearchBySoftwareUpdateDeploymentPackageId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SoftwareUpdateDeploymentPackageName

Hiermee geeft u de naam van een geïmplementeerde software-update op.

Type: String
Parameter Sets: SearchBySoftwareUpdateDeploymentPackageName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-GebruikersNaam

Hiermee geeft u een Windows gebruikersaccountnaam in domein\gebruikersindeling.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

Get-CMAccessAccount

New-CMAccessAccount

Remove-CMAccessAccount

Get-CMApplication

Get-CMBootImage

Get-CMDriverPackage

Get-CMOperatingSystemImage

Get-CMOperatingSystemInstaller

Get-CMPackage

Get-CMSoftwareUpdateDeploymentPackage