New-CMAccessAccount
SYNOPSIS
Adiciona utilizadores ou grupos a uma conta de acesso.
SYNTAX
SearchByValue (Padrão)
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> [-InputObject] <IResultObject>
[-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByApplicationId
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -ApplicationId <String>
[-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByApplicationName
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -ApplicationName <String>
[-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByBootImageId
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -BootImageId <String>
[-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByBootImageName
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -BootImageName <String>
[-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByDriverPackageId
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -DriverPackageId <String>
[-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByDriverPackageName
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -DriverPackageName <String>
[-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByOSImageId
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -OperatingSystemImageId <String>
[-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByOSImageName
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -OperatingSystemImageName <String>
[-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByOSInstallerId
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -OperatingSystemInstallerId <String>
[-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByOSInstallerName
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType>
-OperatingSystemInstallerName <String> [-UserName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByPackageId
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -PackageId <String>
[-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByPackageName
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType> -PackageName <String>
[-UserName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchBySoftwareUpdateDeploymentPackageId
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType>
-SoftwareUpdateDeploymentPackageId <String> [-UserName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchBySoftwareUpdateDeploymentPackageName
New-CMAccessAccount -Access <AccessRight> -AccountType <AccessAccountType>
-SoftwareUpdateDeploymentPackageName <String> [-UserName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
O CmAccessAccount cmdlet adiciona utilizadores ou grupos a uma conta de acesso.
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 ponto de ligação ao ponto de atualização do 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: Modificar o acesso a uma aplicação utilizando o ID da aplicação
PS XYZ:\> $ID = Get-CMAccessAccount -ApplicationID "12994680"
PS XYZ:\> New-CMAccessAccount -ApplicationID $ID -Type WindowsUser Username "CONTOSO\EDaugherty" -Access "FullControl"
O primeiro comando obtém uma identificação de aplicação, e depois armazena-o na variável $ID.
O segundo comando obtém a aplicação que é identificada por $ID e adiciona um utilizador à conta de acesso. As permissões do novo utilizador estão definidas para o FullControl.
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
Especifica a entrada para este cmdlet. Pode utilizar este parâmetro ou canalizar a entrada para este cmdlet.
Type: IResultObject
Parameter Sets: SearchByValue
Aliases: Application, BootImage, DriverPackage, OperatingSystemImage, OperatingSystemInstaller, Package, SoftwareUpdateDeploymentPackage
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
-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.