Set-CMAccessAccount
SYNOPSIS
Modifica as propriedades de uma conta de acesso.
SYNTAX
SearchByValue (Padrão)
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
O Set-CMAccessAccount cmdlet modifica as propriedades de uma conta de acesso. Pode adicionar utilizadores ou grupos à conta de acesso e alterar o nível de permissões a objetos aos quais têm permissões.
Uma conta de acesso é uma lista de utilizadores ou grupos que podem aceder a um serviço ou aplicação estabelecido que está localizado num ponto de distribuição. Por exemplo, os membros da Conta de Acesso ao Acesso ao Ponto de Ligação de Pontos de Atualização de Software podem aceder a dois serviços para gerir atualizações de software: Windows Server Update Services (WSUS) e WSUS Synchronization Manager.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Alterar o acesso a um pacote utilizando o nome do pacote
PS XYZ:\> $Name = Get-CMAccessAccount -PackageName "Configuration Manager Client Package"
PS XYZ:\> Set-CMAccessAccount -PackageName $Name -Type User -UserName "CONTOSO\PFuller" -Access Read -Confirm
O primeiro comando recebe o nome do pacote, e depois armazena-o na variável $Name.
O segundo comando define permissões de acesso para o utilizador à embalagem a ler. Deve confirmar a ação antes que o comando a execute.
PARAMETERS
-Acesso
Especifica os direitos de acesso associados a uma conta de acesso. Os valores válidos são: Sem Acesso, Leitura, Alteração e Controlo Total.
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
-Tipo de Conta
Especifica um tipo de conta. Os valores válidos são: Hóspede, Utilizador, WindowsGroup e 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
Especifica a identificação de uma aplicação.
Type: String
Parameter Sets: SearchByApplicationId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de aplicação
Especifica o nome de uma aplicação.
Type: String
Parameter Sets: SearchByApplicationName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BootImageId
Especifica a identificação de uma imagem de arranque.
Type: String
Parameter Sets: SearchByBootImageId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BootImageName
Especifica o nome de uma imagem de arranque.
Type: String
Parameter Sets: SearchByBootImageName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DriverPackageId
Especifica a identificação de um pacote de motorista.
Type: String
Parameter Sets: SearchByDriverPackageId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DriverPackageName
Especifica o nome de um pacote de motorista.
Type: String
Parameter Sets: SearchByDriverPackageName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com 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
-OperarSystemImageId
Especifica a identificação de uma imagem do sistema operativo.
Type: String
Parameter Sets: SearchByOSImageId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OperatingSystemImageName
Especifica o nome de uma imagem do sistema operativo.
Type: String
Parameter Sets: SearchByOSImageName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OperatingSystemInstallerId
Especifica a identificação de um instalador do sistema operativo.
Type: String
Parameter Sets: SearchByOSInstallerId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OperatingSystemInstallerName
Especifica o nome de um instalador do sistema operativo.
Type: String
Parameter Sets: SearchByOSInstallerName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageId
Especifica o ID de um script ou programa de software implantado.
Type: String
Parameter Sets: SearchByPackageId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome do pacote
Especifica o nome de um script ou programa de software implantado.
Type: String
Parameter Sets: SearchByPackageName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- PassThru
Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SoftwareUpdateDeploymentPackageId
Especifica o ID de uma atualização de software implementada.
Type: String
Parameter Sets: SearchBySoftwareUpdateDeploymentPackageId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SoftwareUpdateDeploymentPackname
Especifica o nome de uma atualização de software implementada.
Type: String
Parameter Sets: SearchBySoftwareUpdateDeploymentPackageName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserName
Especifica um nome de conta de utilizador Windows no formato domínio\user.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.