Set-SPOSiteRestrictedAppAccessControlMode

모듈:
Microsoft.Online.SharePoint.PowerShell Module

사이트 수준 애플리케이션 제한 정책의 활성 모드를 또는 Deny또는 로 설정하고 Allow 사이트 사용 및 두 목록을 모두 유지합니다.

구문

Default (기본값) 

Set-SPOSiteRestrictedAppAccessControlMode
    [-Identity] <String>
    -Mode <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

cmdlet을 Set-SPOSiteRestrictedAppAccessControlMode 사용하여 사이트에서 적용할 목록을 변경합니다. 이 cmdlet은 활성 모드만 변경합니다. 사이트 활성화와 허용 목록 및 거부 목록을 모두 유지합니다.

애플리케이션 제한은 이미 Microsoft Entra 동의 및 SharePoint 권한이 있는 애플리케이션에 대한 SharePoint 권한 부여 경계를 추가합니다. 권한을 부여하지 않으며 Entra 동의를 대체하지도 않습니다. 요청은 기존 사용 권한 모델과 애플리케이션 제한을 모두 통과해야 합니다.

활성 모드는 적용되는 목록을 선택합니다.

  • 허용 - 허용 목록의 응용 프로그램이 응용 프로그램 제한 검사를 통과하고 다른 모든 관리되는 응용 프로그램은 사이트 정책에 의해 거부됩니다. 활성 허용 목록이 비어 있으면 사이트 정책이 모든 관리되는 타사 및 에이전트 응용 프로그램을 거부합니다.
  • 거부 - 거부 목록에 있는 응용 프로그램이 사이트 정책에 의해 거부되고 다른 모든 관리되는 응용 프로그램이 응용 프로그램 제한 검사를 통과합니다. 활성 거부 목록이 비어 있으면 사이트 정책에서 해당 목록을 거부하지 않습니다.

두 목록 모두 항상 저장되며 어떤 모드가 활성 상태인지에 관계없이 관리할 수 있습니다. 활성 모드에서 선택한 목록만 런타임 적용에 참여합니다. 비활성 목록은 향후 모드 변경을 위해 보존되며 런타임 효과가 없습니다. 사이트 정책을 사용하도록 설정하기 전에 모드를 명시적으로 구성해야 합니다.

모드 전환은 사이트의 모든 관리되는 응용 프로그램에 대한 효과적인 결정을 변경할 수 있으므로 cmdlet은 변경하기 전에 경고를 표시합니다. 경고는 현재 모드, 대상 모드, 새로 활성화된 보존 목록의 크기 및 새로운 기본 결정을 식별하며 두 목록이 모두 보존됨을 명확하게 나타냅니다. 그런 다음 cmdlet에서 확인을 요청합니다. 정책을 변경하지 않고 동일한 영향을 표시하는 데 사용합니다 -WhatIf .

구성 및 사용은 직교입니다. 모드 변경으로 적용이 켜지지 않습니다. 사이트 적용은 사용자에 의해 Enable-SPOSiteRestrictedAppAccessControl서만 켜지므로 모드 및 목록을 준비한 다음 사이트를 명시적으로 사용하도록 설정할 수 있습니다. 백엔드가 거부하는 유일한 조합은 mode None.

사이트 적용은 테넌트 스위치에 의해서도 열립니다. 테넌트 스위치가 켜져 있는 동안에는 테넌트 거부 목록이 우선하며 사이트 허용 목록으로 재정의할 수 없습니다.

자동화는 표준 -Confirm:$false. 프롬프트를 표시하지 않아도 유효성 검사, 권한 부여, 감사 또는 자사 보호가 무시되지 않습니다.

사이트 응용 프로그램 제한 관리는 범용 Get-SPOSite 및 Set-SPOSite cmdlet과 격리됩니다. Get-SPOSite 사이트 정책 데이터를 로드하지 않으며 Set-SPOSite 변경할 수 없습니다. 관련 링크에 나열된 전용 애플리케이션 제한 cmdlet을 사용합니다.

SharePoint Online용 Windows PowerShell의 사용 권한과 최신 정보는 SharePoint Online 관리 셸 소개의 온라인 설명서를 참조하세요.

예제

예 1

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow

이 예제에서는 재무 사이트의 활성 모드를 다음으로 설정합니다.Allow 사이트 허용 목록의 응용 프로그램은 응용 프로그램 제한 검사를 통과하고 다른 모든 관리되는 응용 프로그램은 사이트 정책에 의해 거부됩니다. 기존 Microsoft Entra 동의 및 SharePoint 권한 부여는 계속 적용됩니다. 거부 목록은 유지되지만 비활성 상태가 됩니다. cmdlet은 모드 전환 경고를 표시하고 변경 내용을 적용하기 전에 확인을 요청합니다.

예 2

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Deny -WhatIf

이 예에서는 정책을 변경하지 않고 현재 모드, 대상 모드, 새로 활성화된 거부 목록의 크기 및 새로운 기본 결정을 포함하여 재무 사이트를 전환했을 때 Deny의 영향을 표시합니다.

예 3

Set-SPOSiteRestrictedAppAccessControlMode -Identity 8a1e30f6-2f52-4b9e-9d1b-2e9f6c1d40aa -Mode Deny -Confirm:$false

이 예제에서는 자동화에 사용하기 위해 ID로 식별되는 사이트를 확인 없이 전환합니다 Deny . 프롬프트를 표시하지 않아도 유효성 검사, 권한 부여, 감사 또는 자사 보호가 무시되지 않습니다.

예 4

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow
Enable-SPOSiteRestrictedAppAccessControl -Identity https://contoso.sharepoint.com/sites/Finance

이 예에서는 모드를 먼저 스테이징한 다음 명시적으로 적용을 켭니다. 모드 변경은 자체적으로 적용을 설정하지 않습니다.

매개 변수

-Confirm

적용 가능: SharePoint Online

cmdlet을 실행하기 전에 확인 메시지를 표시합니다. 이 cmdlet은 , 를 사용 ConfirmImpact.High하므로 기본적으로 프롬프트를 표시합니다. 자동화에서 프롬프트를 표시하지 않는 데 사용합니다 -Confirm:$false .

매개 변수 속성

형식:System.Management.Automation.SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:CF

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Identity

적용 가능: SharePoint Online

구성할 사이트를 지정합니다. 사이트 URL 또는 사이트 ID를 지정할 수 있습니다.

매개 변수 속성

형식:System.String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:0
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Mode

적용 가능: SharePoint Online

사이트 정책의 활성 모드를 지정합니다. 유효한 값은 Allow 및 Deny입니다.

모드Allow가 인 경우 허용 목록의 응용 프로그램은 응용 프로그램 제한 검사를 통과하고 다른 모든 관리되는 응용 프로그램은 사이트 정책에 의해 거부됩니다. 모드가 인 Deny경우 거부 목록의 응용 프로그램은 사이트 정책에 의해 거부되고 다른 모든 관리 응용 프로그램은 응용 프로그램 제한 검사를 통과합니다. 두 목록 모두 유지됩니다. 기존 Microsoft Entra 동의 및 SharePoint 권한 부여는 계속 적용됩니다.

매개 변수 속성

형식:System.String
Default value:None
허용되는 값:Allow, Deny
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

적용 가능: SharePoint Online

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다. -WhatIf 정책을 변경하지 않고 확인 경고와 동일한 모드 전환 영향을 표시합니다.

매개 변수 속성

형식:System.Management.Automation.SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:wi

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable과 같은 일반 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

System.String

출력

None

참고

  • 모드 변경은 활성 모드만 변경합니다. 사이트 사용과 두 목록을 모두 유지합니다.
  • 전환 전에 cmdlet은 현재 모드, 대상 모드, 새로 활성화된 보존 목록의 크기 및 새 기본 결정과 함께 경고합니다.
  • 경고에는 두 목록이 모두 보존된다는 내용이 표시되고 cmdlet에서 확인을 요청합니다.
  • 활성 허용 목록이 비어 있으면 사이트 정책이 모든 관리되는 타사 및 에이전트 응용 프로그램을 거부합니다. 활성 거부 목록이 비어 있으면 사이트 정책에서 해당 목록을 거부하지 않습니다. 기존 Microsoft Entra 동의 및 SharePoint 권한 부여는 계속 적용됩니다.
  • 구성 및 사용은 직교로 이루어집니다. 사이트 적용은 에 의해 Enable-SPOSiteRestrictedAppAccessControl서만 켜집니다. 백엔드가 거부하는 유일한 조합은 mode None.
  • 테넌트 스위치는 모든 사이트 적용을 게이트합니다. 테넌트 스위치가 켜져 있는 동안에는 사이트 허용 목록으로 테넌트 거부 목록을 재정의할 수 없습니다.
  • 결과 모드와 두 목록을 확인하는 데 사용합니다 Get-SPOSiteRestrictedAppAccessControl .